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Introduction 



This manual is intended to supplement information contained 
in the User's Reference Manual and the Programmer's Reference 
Manual. It provides an easy reference volume for those responsi- 
ble for administering a 6000/50 system. 

The manual is divided into two sections: 

1. System Maintenance Commands and Application 

Programs 
7. Special Files 

Throughout this volume, a reference of the form name (1M), or 
name {7), refers to entries in this manual, while all other references 
to entries of the form name(H), where N is a number, possibly fol- 
lowed by a letter, refer to entry name in Section N of the User's 
Reference Manual or the Programmer's Reference Manual, 

Section 1 (System Maintenance Commands and Application 
Programs) contains commands and programs that are used in 
administering a 6000/50 system. These entries carry a sub-class 
designation of "1M" for cross-referencing reasons. 

Section 7 {Special Files) discusses the characteristics of sys- 
tem files that refer to input/output devices. The names in this sec- 
tion generally refer to device names for the hardware, rather than 
to the names of the special files themselves. 

Each section begins with a page labelled intro. Entries follow- 
ing the intro page are arranged alphabetically and may consist of 
more than one page. Some entries describe several routines, 
commands, and so forth. In such cases, the entry appears only 
once, alphabetized under its "primary" name. An example of such 
an entry is mount {^U), which also describes the umount command. 

All entries are based on a common format, not all of whose 
parts always appear: 

• The NAME part gives the name(s) of the entry and briefly 
states its purpose. 

• The SYNOPSIS part summarizes the use of the program 
being described. A few conventions are used, particularly in 
Section 1M {Commands): 
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Boldface strings are literals and are to be typed just as 
they appear. 

Regular face strings usually represent substitutable argu- 
ment prototypes and program names found elsewhere 
In the manual. 

Square brackets [] around an argument prototype Indi- 
cate that the argument is optional. When an argument 
prototype is given as "name" or "file," it always refers 
to a file name. 

Ellipses ... are used to show that the previous argument 
prototype may be repeated. 

• The DESCRIPTION provides an overview of the command. 

• The EXAMPLE(S) part gives example(s) of usage, where 
appropriate. 

• The FILES part gives the file names that are built into the 
program. 

• The SEE ALSO part gives pointers to related information. 

• The DIAGNOSTICS part discusses the diagnostic indica- 
tions that may be produced. Messages that are intended to 
be self-explanatory are not listed. 

• The WARNINGS part points out potential pitfalls. 

• The BUGS part gives known bugs and sometimes deficien- 
cies. 

A "Table of Contents" and a "Permuted Index" derived from 
the Table of Contents precede section 1 . Both are valuable 
resources to be used when locating information you need quickly 
and easily. 

The "Permuted Index" is a list of keywords, given in the 
second of three columns, together with the context in which the 
keyword is found. Keywords are either topical keywords or the 
names of manual entries. Entries are identified with their section 
numbers shown in parentheses. The right column lists the name 
of the manual page on which each keyword may be found. The 
left column contains useful information about the keyword. 
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1 . Commands 

intro(1M) introduction to maintenance commands 

and application programs 

accept, reject(lM) allow or prevent LP requests 

acct: acctdisk, acctdusg, accton, acctwtmp(IM) overview of 

accounting and miscellaneous accounting commands 

acctcms(IM) , command summary from 

per-process accounting records 

acctcon: acctconl, acctcon2(1M) connect-time accounting 

acctmerg{1M) merge or add total accounting files 

acctprc: acctprd, acctprc2(1M) process accounting 

acctsh: chargefee, ckpacct, dodisk, lastlogin, monacct, nulladm, 
prctmp, prdaily, prtacct, runacct, shutacct, startup, 

turnacct(IM) , , shell procedures for accounting 

adv(1M) advertise a directory for remote access 

bcopy(1M) interactive block copy 

brc, bcheckrc, powerfail(IM) .......... system initialization procedures 

captoinfo(IM) convert a termcap description into 

a terminfo description 

cdc(1M) change the delta commentary of an SCCS delta 

cdt{1M) read crash dump table 

checkfsys{l M) check a file system on a removable disk 

chroot(1M) change root directory for a command 

ckbupscd(IM) check file system backup schedule 

clri(1M) clear i-node 

config(lM) configure a 6000/50 system 

cons(1M) control of system console 

cpset(lM) install object files in binary directories 

cram(lM) read/write CMOS RAM 

cramsetup(lM) set up default values in CMOS RAM 

crash(lM) examine system images 

cron(1M) clock daemon 

ctinstall, getgrps(IM) install software 

dcopy(1M) copy file systems for optimal access time 

dd(1M) convert and copy a file 

devnm(1M) device name 
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df(lM) report number of free disk blocks and i-nodes 

diskusg(IM) generate disk accounting data by user ID 

diskutil(IM) display disk information, copy in crash dump files 

dname(1M) print Remote File Sharing domain and network names 

drvload(lM) ..... , , load drivers 

du(1M) , summarize disk usage 

errdead{1M) extract error records and status 

information from dump 

errdemon(IM) error-logging daemon 

errpt{1 M) process a report of logged errors 

errstop(lM) terminate the error-logging daemon 

ff (1M) list file names and statistics for a file system 

frec{1M) recover files from a backup tape 

fsck, dfsck, checkall(IM) check and repair file systems 

fsdb(1M) file system debugger 

fsstat(lM) report file system status 

fstyp(lM) determine file system identifier 

f umount(1 M) forced unmount of an advertised resource 

fusage(lM) disk access profiler 

fuser(1M) identify processes using a file or file structure 

gencc(1 M) create a front-end to the cc command 

getty(lM) set terminal type, modes, speed, and line discipline 

hinv(lM) hardware inventory 

id{lM) print user and group IDs and names 

idload(1M) Remote File Sharing user and group mapping 

infocmp(1 M) compare or print out terminfo descriptions 

init, telinit(IM) process control initialization 

install(IM) install commands 

kcrash(1M) examine system images 

kdb(lM) Kernel Debug Monitor 

killall(IM) kill all active processes 

labelit(lM) provide labels for file systems 

fddrv(1M) manage loadable drivers 

link, unlink(1M) link and unlink files and directories 

lpadmin(1M) configure the LP spooling system 

Ipsched, Ipshut, lpmove(1M) start/stop the LP scheduler 

and move requests 

lpset{1M) set parallel line printer options 

masterupd(IM) update the master file 

mkdbcmd{1 M) load commands into the kernel debugger 

mkdbsym(IM) add symbols to kernel debugger 
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mkfs(1M) construct a file system 

mkifile(1 M) make an ifile from an object file 

mklost+ found (1M) make a lost + found directory for fsck 

mknod(1M) build special file 

mount, umount(1M) mount and unmount file systems 

and remote resources 

mountall, umountall(IM) mount, unmount multiple file systems 

mvdir(l M) move a directory 

ncheck(1M) generate path names from i-numbers 

newgrp(1M) log in to a new group 

nlsadmin(lM) network listener service administration 

nmlmaint(IM) loadable driver name list maintenance 

nsquery(IM) Remote File Sharing name server query 

profiler: prfld, prfstat, prfdc, prfsnap, prfpr(1M) 6000/50 

system profiler 

pwck, grpck(1M) password/group file checkers 

qinstall(IM) install and verify software using 

the mkfs(1M) proto file database - 

qlist(1M) print file lists from proto file; 

set links based on lines in proto file 
rc0(1M) ... run commands performed to stop the operating system 

rc2(l M) run commands performed for multi-user environment 

reboot(1M) reboot the system 

renice{1 M) alter priority of running process by changing nice 

rfadmin(lM) Remote File Sharing domain administration 

rfpasswd(IM) change Remote File Sharing host password 

rfstart(IM) start Remote File Sharing 

rfstop{1 M) stop the Remote File Sharing environment 

rfuadmin(IM) Remote File Sharing notification shell script 

rfudaemon(IM) Remote File Sharing daemon process 

rmntstat(IM) display mounted resource information 

rmount(1M) retry remote resource mounts 

rmountall, rumountall(IM) mount, unmount Remote 

File Sharing resources 

runacct(lM) run daily accounting 

sadp(1M) disk access profiler 

sar: sal, sa2, sadc(1M) system activity report package 

scpioctl(lM) download code to active SCP boards. 

scsicnfg(IM) configure devices on the SCSI bus 

setmnt(1M) establish mount table 

shutdown, halt(1M) shut down system, change system state 
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strace(1M) print STREAMS trace messages 

strclean(IM) STREAMS error logger cleanup program 

strerr(1M) STREAMS error logger daemon 

su(1M) become super-user or another user 

swap(1M) swap administrative interface 

sync(1M) update the super block 

sysadm{1M) menu "interface to do system administration 

sysdef(1M) output system definition 

tic(1M) terminfo compiler 

tsdbadm(IM) Remote Terminal service database administration 

tslimit(IM) Remote Terminal service limits administration 

uadmin(1M) administrative control 

unadv{1 M) unadvertise a Remote File Sharing resource 

uucheck(1 M) check the uucp directories and permissions file 

uucico(1M) file transport program for the uucp system 

uucleanup(IM) uucp spool directory clean-up 

uugetty(IM) .... set terminal type, modes, speed, and line discipline 

uusched(IM) the scheduler for the uucp file transport program 

Uutry(1M) try to contact remote system with debugging on 

uuxqt(1M) , execute remote command requests 

volcopy(t M) copy file systems with label checking 

whodo(1M) who is doing what 

7. Special Files 

intro(7) introduction to special files 

clone(7) open any minor device on a STREAMS driver 

disk(7) disk format and driver 

drivers(7) loadable device drivers 

enet(7) Ethernet interface and control 

err(7) error-logging interface 

fd(7) floppy disk (diskette) 

log(7) interface to STREAMS error logging and event tracing 

lp(7) parallel printer interface 

mem, kmem(7) system memory image 

nuli(7) the null file 

prf{7) operating system profiler 

ramdisk, uramdisk(7) RAM disk drivers 

sa(7) devices administered by System Administration 

scpa(7) ., SCP active mode interface 

scsi{7) SCSI busses and peripherals 

streamio(7) STREAMS ioctl commands 
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sxt(7) , pseudo- device driver 

termio(7) ., general terminal interface 

timod{7) ........... Transport Interface cooperating STREAMS module 

tirdwr(7) Transport Interface read/write interface 

STREAMS module 

tty(7) controlling terminal interface 

vt(7) virtual terminal 
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configure a 
advertise a directory for remote 
disk 
disk 

copy file systems for optimal 
acctcori2(1 M) connect-time 
*ectprc1{1M) acctprc2(1M) process 
generate disk 
merge or add total 
run daily 
connect- Ume accounting 
accounting acctcon1(1M) 
acctwtmp(IM) 
scctdlskflM) 
acctdisk(1M} aeddusgflM) 
accounting 
acctprc1(1M) 

acctdisk(IM) acctdusg{lM) accton(lM) 
SCP 
kiUall 

download cod* to 
sal(1M) sa2(tM) sadc(lM) system 

merge or 
devices 

network listener service 
Remote File Sharing domain 
devices administered by System 
menu interlace to do system 
Remote Terminal service database 
Remote Terminal service limits 

swap 
access 

forced unmount of an 
re)ect(IM) 
changing nice 
check file system 
recover files from a 
initialization procedures 
install object riles in 
interactive 
update the super 
report number of tree disk 

configure devices on the SCSI 
SCSI 

create a front-end to the 
after priority of running process by 
lastlogin(IM) monacct(IM)/ 
disk 

dfsck(IM) checkall(tM) 

permissions file 
systems dfsck(1M) 
grpck(1M) password/group file 
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config{1M) 

adv{1M) 

fusage(IM) 

sadp(1M) 

dcopy(IM) 

acctcon(1 M) 

acctprc(lM) 



access profiler , 

access profiler . — „„ — 

access time 

accounting acctcon1(1M) 

accounting „ 

accounting data by user ID diskusgflM) 

accounting files .... acctmerg(iM) 

accounting .. — M „„. runacct{1M) 

acctcon1{1M) acdeon2(1M) acclcon(lM) 

acctcon2(1M) connect-time acctcon{1M) 

acctdtak(lM) acctdusg(iM) scetonfjM) acct(iM) 

acctdusg(IM) accton(lM) acctwtmp(lM) acct(lM) 

accton(lM) acctwtmp(lM) acct(1M) 

acctprci(lM) acctprc2(lM) process acctprc(iM) 

acctprc2(lM) process accounting acctprc(IM) 

acctwtmp(IM) acct(lM) 

active mode Interface acpa(7) 

active processes killall(IM) 

active SCP boards. scploctl(tM) 

activity report package sar(IM) 

add symbols to kernel debugger mkdbsym(1 M) 

add total accounting files .. acctmerg(lM) 

administered by System Administration sa(7) 

administration nlsadmin(lM) 

administration „ rfadmln(IM) 

Administration sa(7) 

administration sysadm(1 M) 

administration .... tsdbadm(IM) 

administration — tslimit(IM) 

administrative control uadmin(i M) 

administrative interface swap(lM) 

advertise a directory for remote adv{1M) 

advertised resource fumount(lM) 

allow or prevent LP requests accept(l M) 

after priority of running process by renice(1 M) 

backup schedule ckbupscd(1 M) 

backup tape frecflM) 

bcheckrc(IM) powerfall(lM) system brc(lM) 

binary directories cpseHIM) 

block copy „ bcopy(IM) 

block ..... sync(1M) 

blocks and V- nodes d!{lM) 

build special file mknod(tM) 

bus scsicnfg(fM) 

busses and peripherals scsi(7) 

cc command gencc'tM) 

changing nice renice(1M) 

chargefee(lM) ckpacct(lM) dodlsk(iM) acctsh{iM) 

check a file system on a removable checkfsysji M) 

check and repair file systems fsck{lM) 

check file system backup schedule ckbupscdfiM) 

check the uucp directories and uucheek{l M) 

checkaiiflM) check and repair file Isck(lM) 

checkers . — pwck(lM) 
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copy file systems with label 
monacct(IM)/ chargefee(lM) 
STREAMS error logger 
uucp spool directory 



read/write 
set up default values tn 
download 
change root directory for a 
create a front-end to the cc 
execute remote 
Install 
load 

environment run 
operating system run 
STREAMS loctl 
change the delta 
descriptions 
terminfo 



acctcon1(lM} acctcon2(1M) 
control of system 

on try to 
Ethernet interface and 
telinit(iM) process 

administrative 



Transport Interface 
convert and 
interactive block 
time 

display disk information, 
display disk information, copy in 
read 
command 
clock 
error-logging 
terminate the error-logging 
Remote File Sharing 
STREAMS error logger 
run 

generate disk accounting 
Remote Terminal service 
Kernel 
file system 
load commands into the kernel 
add symbols to kernel 
try to contact remote system with 
set up 
output system 



checking „.... OT ..«..„..„..— volcopy(IM) 

ckpacct(IM) dodlsk(1M) tastlogin(IM) acctsh(1M) 

cleanup program strclean(tM) 

clean-up „.„ - uucleanup(lM) 

clear i-noda ... clri{1M) 

clock daemon ..................... cron(1M) 

CMOS RAM „...„„..,„.., . — , cram(1M) 

CMOS RAM cramsetup(lM) 

i code to active SCP boards scploctl(IM) 

command ................................... chroot(lM) 

command ........................................... gencc(1M) 

command requests uuxqt(lM) 

commands .................................. install(lM) 

commands Into the kernel debugger mkdbcmd(lM) 

commands performed for multi-user rc2(1M) 

commands performed to atop the rcO(1M) 

commands .................................. — s!reamio(7) 

commentary of an SCCS delta cdc(1M) 

compare or print out terminfo Infocmp(tM) 

compiler „ Hc(1M) 

configure a 6000/50 system - config(1M) 

configure devices on the SCSI bus scsicnfg{1M) 

configure the LP spooling system !padmin{1 M) 

connecMlme accounting acctcon(lM) 

console ............ cons(1M) 

construct a file system '. mkfs{lM) 

contact remote system with debugging .......... Uutry[lM) 

control ............................ enet{7) 

control initialization init(1M) 

control of system console cons(1M) 

control ............................... uadmin(1M) 

controlling terminal Interface tty(7) 

convert and copy a file dd(1 M) 

cooperating STREAMS module ; tlmod(7) 

copy a file .... dd(1M) 

copy bcopy(1M) 

copy file systems for optima! access ............. dcopy(iM) 

copy file systems with label checking voicopy(IM) 

copy In crash dump files diskutll(lM) 

crash dump files ... diskutil(tM) 

crash dump table cdt(tM) 

create a front-end to the cc gencc(1M) 

daemon ............. cron(lM) 

daemon , errdemon(IM) 

daemon ......... . ... errstop(IM) 

daemon process „ rfudaemon{1 M) 

daemon ....... . ... strerr(1 M) 

daily accounting ..... runacct(IM) 

data by user ID .„„..,...,.........„. diskusg(IM) 

database administration ..... tsdbadm(IM) 

Debug Monitor . kdb(1M) 

debugger „ fsdb(1M) 

debugger « ......... mkdbcmd(IM) 

debugger mkdbsym{1M} 

debugging on UutryO M) 

default values in CMOS RAM crams etup(1M) 

definition .„ .. sysdef(1M} 
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the delta commentary of an SCCS delta change cdcflM} 

change the delta commentary of sn SCCS delta cdc(1M) 

compare or print out terminfo descriptions , infocmp(1 M) 

determine file system Identifier fstyp(1M) 

loadable device drivers drivers(7) 

device name , devnm(1M) 

open any minor device on a STREAMS driver clone(7) 

Administration devices administered by System sa(7) 

configure devices on the SCSI bus scsicnfg(IM) 

repair fife systems dfsck(1M) checkall(IM) check and fsck(1M) 

check the uucp directories and permissions file uucheck{1M) 

install object files In binary directories „ cpset(tM) 

unlink(1M) link and unlink files and directories link(tM) 

uucp spool directory clean-up uucleanup(IM) 

change root directory for a command chroot{1M) 

make a lost+found directory for fsck mklosWound(IM) 

advertise a directory for remote access adv(lM) 

move a directory mvdir(lM) 

terminal type, modes, speed, and line discipline set getty(1M) 

terminal type, modes, speed, and line discipline set uugetty(lM) 

disk access profiler fusage(1M) 

disk access profiler sadppM) 

generate disk accounting data by user ID diskusg(IM) 

report number of free disk blocks and i-nodes df(l M) 

check a file system on a removable disk checkfsys(IM) 

floppy disk (diskette) td(7) 

uramdlsk{7) RAM disk drivers ramdisk(7) 

disk format and driver disk{7) 

files display disk information, copy in crash dump dtskutil(IM) 

summarize disk usage du(lM) 

floppy disk (diskette) .„„ ld(7) 

crash dump files display disk Information, copy in diskutil(IM) 

display mounted resource information rmntstatfiM) 

chargefee(-lM) ckpacctflM) dodlsk(1M} iastlogln(lM) monacct(IM)/ ........ acctsh{1M) 

who is doing what — whodoi.1 M) 

Remote File Sharing domain administration rfadmin{lM) 

print Remote File Sharing domain and network names . dname(1M) 

download code to active SCP boards. ........ scpioctl(IM) 

open any minor device on a STREAMS driver clone(7) 

disk format and driver disk(7) 

loadable driver name list maintenance nmlmaint(1 M) 

pseudo-device driver sxt(7) 

loadable device drivers drivers(7) 

load drivers.... drvload(IM) 

manage loadable drivers lddrv(1M) 

uramdisk(7) RAM disk drivers ramdisk(7) 

disk Information, copy In crash dump files display diskutil(IM) 

read crash dump table cdt(iM) 

commands performed for multi-user environment run rc2{1M) 

stop the Remote File Sharing environment ristop{1M) 

STREAMS error logger cleanup program strclean{1 M) 

STREAMS error logger daemon strerr(lM) 

Interface to STREAMS error logging and event tracing log{7) 

error-logging daemon errdemon(IM) 

terminate the error-logging daemon errstop(IM) 

error-logging interface err(7) 

process a report of logged errors errpt(1 M) 
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grpck(1M) password/group 
convert and copy a 
update the master 
make an ifile from an object 
build special 
system list 
the null 

identify processes using a 
Remote 
Remote 
print Remote 
stop the Remote 
change Remote 
Remote 
script Remote 
unadvertisa a Remote 
start Remote 
Remote 

identify processes using a Tile or 
check 

list file names and statistics for a 
determine 
construct a 
check a 
report 
copy 

checkail(lM) check and repair 
provide labels for 
umountail(IM) mount, unmount multiple 

copy 
system 

the scheduler (or the uucp 
the uucp directories and permissions 
merge or add total accounting 
unllnk(1 M) link and unlink 
disk information, copy in crash dump 
recover 
install object 
introduction to special 

resource 
disk 

report number of 
recover files 
make an ifile 
generate path names 
create a 

make a losWound directory for 
ID 



establish mount table .... setmnt(1 M) 

Ethernet Interface and control enet(7) 

event tracing intedace iog(7) 

examine system images .'. crash{1M) 

examine system images kcrash(1 M) 

execute remote command requests uuxqt(lM) 

file checkers .. pwck(1M) 

file dd(lM) 

file masterupd(IM) 

file mkifile(IM) 

file mknod(1M} 

file names and statistics for a file ff(1M) 

file . ............ null(7) 

file or file structure fuser(lM) 

File Sharing daemon process rfudaemon(IM) 

File Sharing domain administration rfadmin{1M) 

File Sharing domain and network names dname(IM) 

File Sharing environment rfstop(lM) 

File Sharing host password rfpass wd{1 M) 

File Sharing name server query nsquery(IM) 

File Sharing notification shell rfuadmin(IM) 

File Sharing resource unsdv(1M) 

File Sharing . rfstart(IM) 

File Sharing user and group mapping ........... idload(1 M) 

file structure - fuser(1M} 

file system backup schedule ckbupscd(1 M) 

file system debugger fsdb(1M) 

file system , ff{lM) 

file system identifier fsfyp(1M} 



file system ........ mkfs(1 M) 

file system on a removable disk ............... checkfsys(1 M) 

file system status — fsstat(lM) 

file systems for optimal access time .............. dcopy(tM) 

file systems dfsck(1M) fsck(IM) 

file systems .......... . labelit(lM) 

file systems mountall(1 M) 

file systems with label checking volcopy(l M) 

file transport program for the uucp uucico(1M) 

file transport program uusched(IM) 

file check ........... uucheck(1 M) 

files .... . . .. — acctmerg(IM) 

files and directories link(lM) 

files display diskutil{1 M) 

files from a backup tape frec(1 M) 

files in binary directories cpset(1 M) 

files ........ intro{7) 

floppy disk (diskette) fd(7) 

forced unmount of an advertised fumount(lM) 

format and driver .... ...„ disk{7} 

free disk blocks and t-nodes df(1M) 

from a backup tape . — frec(1M) 

from an object file mkifile(IM) 

from {-numbers '. ncheck(1 MJ 

front-end to the cc command gencc(l M) 

fsck . . ..„ mklost+found{1M) 

generate disk accounting data by user ....... diskusg(lM) 

generate path names from (-numbers ncheck(1 M) 
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getgrps(lM) install software 


.... ctlnstall(IM) 


print user and 


group 10s and names .. 


id(1M) 


Remote File Sharing user and 


group mapping 


...... idioad(1M) 


log in to a new 


Sr°up »... 


.... newgrp(1M) 


checkers 


grpck(1M) password/group file 


pwck(1M) 


system state 


halt(lM} shut down system, change 


shutdown^ M) 




hardware Inventory 


... ■ hinv(1M) 


change Remote File Sharing 


host password 


- rfpasswd(IM) 


generate disk accounting data by user 


ID _ 


... diskusg(IM) 


determine file system 


Identifier _ 


fstyp<1M) 


file structure 


Identify processes using a file or 


fuser(1M) 


print user and group 


IDs and namas 


id{1M) 


make an 


ifile from an object file 


...... mkifliejlM) 


kmem(7) system memory 


image 


........... mem(7) 


examina system 


images 


erashflM) 


examine system 


images 


— kcrash{1M) 


display disk 


information, copy in crash dump files ...... 


diskutil(IM) 


telinit(lM) process control 


Initialization 


init(1M) 


bcheckrc(IM) powerfail(IM) system 


initialization procedures 


brc(1M) 


clear 


l-node 


clri(1M) 


report number of free disk blocks and 


l-nodes 


df(lM) 




install commands 


install (1M) 


directories 


install abject flies in binary 


cpset(1M) 


getgrps(iM) 


Insiall software 


, ... r*instaU(1M) 




imemctlvo block copy ............. 


bcopy(lM) 


Ethernet 


Interface and control , 


enet(7) 


Transport 


Interface cooperating STREAMS module 


timodfj) 


error-logging 




err(7) 


parallel printer 




Ip(7) 


SCP active mode 


interlace 


scpa(7) 


swap administrative 


interface , , 


swap(1M) 


general terminal 


Interface 


termio(7) 


menu 


interface to do system administration 


.... sysadmOM) 


and event tracing 


Interface to STREAMS error logging 


iog(7) 


controlling terminal 


Interface 


tty(7) 


generate path names from 


Introduction to special files 


lntro{7) 


{-numbers 


ncheck(1M) 


hardware 


Inventory , 


........... hlnv(lM) 


STREAMS 


iocti commands 


streamio(7} 




Kernel Debug Monitor ............................. 


kdb(1M) 


load commands into the 


kernel debugger 


. mkdbcmd(lM) 


add symbols to 


kernel debugger 


. mkdbsym(IM) 




kill all active processes ............... 


kiilall(IM) 




kmem(7) system memory image ............ 


mem(7) 


copy file systems with 




volcopy(IM) 


provide 


labels for file systems 


labelit(IM) 


chargefee{1M) ckpacct(lM} dodisk(lM) 


lastlogln(IM) monacct(lM) nulladm(lM) 


acctsh(IM) 


Remote Terminal service 


limits administration 


tslimit(IM) 


set terminal type, modes, speed, and 




-» ■• 0etty(1M) 


set terminal type, modes, speed, and 




uugetty(IM) 


set para'iel 


line printer options 


lpset(1M) 


unlink{1M) 


link and unlink files and directories 


link(lM) 


file system 


list file names and statistics for a 


ff(1 M) 


loadable driver name 


list maintenance 


., nmlmaint(IM) 


network 


listener service administration 


„, nlsadmin{iM) 


debugger 


load commands Into the kernel .............. 


.. mkdbcmd{1M) 




load drivers 


drvload(lM) 
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loadable device drivers ~. — drivers(7) 

loadable driver name list maintenance nmlmalnt(IM) 



manage 

process a report of 
STREAMS error 
STREAMS error 
interface to STREAMS error 
make a 

reject (1M) allow or prevent 
configure the 
lpshut(1M) 

loadable driver name list 



Remote File Sharing user and group 
update the 
kmem{7) system 
administration 

print STREAMS trace 
open any 
SCP active 
set terminal type, 
set terminal type, 
Interface cooperating STREAMS 
/ckpacct(IM) dodisk(lM) lastlogin{1M) 
Kernel Debug 
establish 
umountal!(1M) 
display 

retry remote resource 

umountall(1 M) mount, unmount 
run commands performed for 
administration 
print Remote File Sharing domain and 
of running process by changing 
Remote File Sharing 
the 

dodisk(1M) lastlogin(lM) monacct{1M) 
make an tfile from an 
Install 
driver 

run commands performed to stop the 
copy file systems for 
set parallel line printer 

sadc(lM) system activity report 
set 

change Remote File Sharing host 
grpck(1M} 
generate 



loadable drivers lddrv(lM) 

log in to a new group newgrp(tM) 

logged errors ..... errpt(lM) 

logger cleanup program . strclesn(IM) 

logger daemon . strerr(lM) 

logging and event tracing log (7) 

lost+found directory for fsck mklost+found(lM) 

LP requests accept{1M) 

LP spooling system Ipadmin(IM) 

lpmove(1M) Ipsched(IM) 

lpshut(1M) lpmove{1M) Ipsched(IM) 

maintenance — — . nmlmaint(IM) 

make a lost+found directory for fsck . mklost+found(lM) 

make an ifile from an object file mkifile(IM) 

manage loadable drivers Iddrv(tM) 

mapping idload{1M} 

master file ....... ............. masterupd(IM) 

memory Image ~ mem{7) 

menu interface to do system — „ — . sysadm{1M) 

merge or add total accounting files acctmerg(lM) 

messages .... strace(lM) 

minor device on a STREAMS driver clone(7) 

mode Interface ...... «.... scpa(7) 

modes, speed, and line discipline getty(iM) 

modes, speed, and line discipline uugetty(IM) 

module Transport « ~ . — tlmod{7) 

monacct(IM) nulladm(IM) acctsh(1M) 

Monitor kdb{lM) 

mount table — setmnt(1M) 

mount, unmount multiple file systems mountatl(IM) 

mounted resource Information rmntstat(IM) 

mounts rmount(1M) 

move a directory ..™*>«.... ,» mvdir(lM) 

multiple file systems ... mountall(lM) 

multi-user environment .... rc2(1M) 

network listener service nlsadmin(IM) 

network names ... dname(lM) 

nice alter priority renice(1M) 

notification shell script riuadmln(IM) 

null file . nullf.7) 

nulladm(IM) /ckpacct{1M) acctsh(1M) 

abject file mkifile{1M) 

object files in binary directories cpset(lM) 

open any minor device on a STREAMS clone(7J 

operating system profiler prt (7) 

operating system .... — rcO(1M) 

optimal access time dcopy{1M) 

options Ipsel{l M) 

output system definition sysdef(lM) 

package sa1(1M) sa2(1M) .-. sar(1M) 

parallel line printer options lpset(1M) 

parallel printer interface Ip(7) 

password rtpasswd(lM) 

password/group file checkers pwck(1M) 

path names from i-numbers ncheck(lM) 
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environment run commands 
system run commands 
SCSI busses and 
check the uucp directories and 
procedures bcheckrc(lM) 
shutacct(IM) startup(1M}/ 
reject(1M) allow or 
prfld(tM)prfstat{lM} 
prfsnap(IM) prfpr(1M) 
prfstat(lM) prfdc(1M) prfsnap{1M) 
prfld(1M) prfstat(lM) prfdc(1M) 
prfpr(1M) prfld(1M) 
compare or 
network names 



parallel 
set parallel line 
changing nice alter 

acciprd (1 M) acctprc2(1 M) 
alter priority of running 
telinit(lM) 

Remote File Sharing daemon 
kill all active 
structure Identify 
system 
disk access 
operating system 
disk access 

startup(1M} tumacct(IM) prdally(IM) 

Remote File Sharing name seiver 
read/write CMOS 
set up default values in CMOS 
uramdisk(7) 



requests 
advertise a directory for 
execute 

administration 
network names print 
stop the 
change 

shell script 
unadvertise a 
sUrt 
mapping 
retry 
try to contact 
administration 



performed for multi-user rc2{lM) 

performed to stop the operating rcQ(IM) 

peripherals scsi(7) 

permissions file ,. uucheck(lM) 

powerfail(IM) system initialization brc(1M) 

prdally(IM) prtacct(IM) runacct(lM) prctmp(1M) 

prevent LP requests accept(1M) 

prfdc(1M) prfsnap(lM) prfpr{1M) profi!er(1M) 

prfld{1M) prfstat(IM) prfdc(IM) profiler(IM) 

prfprflM) prfld{1M) profiler{1M) 

prfsnap(IM) prfpr(lM) — profiler{1M) 

prfstat(IM) prfdc(1M) prfsnap{1M) profiler(IM) 

printout lerminfo descriptions Infocmp(lM) 

print Remote File Sharing domain and dname{1M) 

print STREAMS trace messages strace(lM) 

print user and group IDs and names ld(1M) 

printer interface Ip{7) 

printer options ...... — 1pset{1M) 

priority of running process by renice(1M) 

process a report of logged errors errpt(1M) 

process accounting acctprc(IM) 

process by changing nice . renice(lM) 

process control initialization ... init(1M) 

process ................................ rfudaemon(tM) 

processes kiltall(IM) 

processes using a file or file fuser(1M) 

profiler 6000/50 

profiler ..... fusage(1M) 

profiler ........... . prf(7) 

profiler „... „ sadp{1M) 

provide labels for file systems labeiit(iM) 

prtacct(IM) runacct(IM) shutacct(IM) prctmp(1M) 

pseudo-device driver sxt{7) 

query nsquery(IM) 

RAM cram(1M) 

RAM .. cramsetup(1 M) 

RAM disk drivers — . ramdisk(7) 

read crash dump table .......... — cdtflM) 

read/write CMOS RAM cram(1M) 

reboot the system reboot(1M) 

recover files from a backup tape frec(1M) 

reject(IM) allow or prevent LP accept(iM) 

remote access ....... , adv(IM) 

remote command requests ... . uuxqt(1M) 

Remote File Sharing daemon process .. rfudaemon(IM) 

Remote File Sharing domain rfadmin(lM) 

Remote File Sharing domain and dname(lM) 

Remote File Sharing environment rfstop(IM) 

Remote File Sharing host password .......... rfpasswd(IM) 

Remote File Sharing name server query .... nsquery(fM) 

Remote File Sharing notification rfuadmin(IM) 

Remote File Sharing resource ......... ....... unadv{1M) 

Remote File Sharing rfstart{1M) 

Remote File Sharing user and group idload(1M) 

remote resource mounts ... , rmount(1M) 

remote system with debugging on Uutry(1M) 

Remote Terminal service database tsdbadm(IM) 



UP-13529 



Index 7 



Permuted Index 



administration 
check a file system on a 
dfsck(1M) checkall(IM) check and 

l-nodes 
process a 

sa2(1M) sadc(lM) system activity 
reject(lM) allow or prevent LP 
execute remote command 
forced unmount of an advertised 
display mounted 
retry remote 
unadvortJse a Remote File Sharing 

change 

multi-user environment 
operating system 

tumacct{1M) prdaily(lM) prtacctflM) 
alter priority of 
activity report package 
report package sa1£1M) 
package sa1(lM) sa2(1M) 
change the delta commentary of an 
check file system backup 
program the 

download code to active 
File Sharing notification shell 
configure devices on the 

Remote File Sharing name 
Remote File 
Remote File 
print Remote File 
stop the Remote File 
change Remote File 
Remote Fiie 
Remote File 
unadvertise a Remote File 
start Remote File 
Remote File 
Remote File Sharing notification 
halt(1M) 

prdaily(tM) prtacct(lM) runacct(IM) 
getgrps(IM) install 
set terminal type, modes, 
set terminal type, modes, 
uucp 

configure the LP 

prtacct(IM) runacct(IM) shutacct(IM) 
list file names and 
report file system 
run commands performed to 
environment 



Remote Terminal service limits tslimlt(IM) 

removable disk checkfsys{1 M) 

repair file systems ... — fsck(lM) 

report file system status fsstat(fM) 

report number of free disk blocks and df(iM) 

report of logged errors errpt(1M) 

report package sat(tM) sar{1M) 

requests ..... accept{!M) 

requests . uuxqt(lM) 

resource furoount(IM) 

resource Information rmntstat(IM) 

resource mounts rmount(lM) 

resource unadv(lM) 

retry remote resource mounts rmount(1M) 

root directory for a command chroot(1M) 

rumountall(IM) rmountall(IM) 

run commands performed for rc2(1M) 

run commands performed to stop the rcO(1M) 

run daily accounting , runacct(IM) 

runacct(IM) shutacct(lM) startup(IM) prctmp(1M) 

running process by changing nice renice(1M) 

sa1(lM) sa2(1M) sadc{1M) system sar(1M) 

sa2(1MJ sadc(1M) system activity sar(1MJ 

sadc(1M) system activity report sar(1M) 

SCCS delta ..... „ cdc(1M) 

schedule .... ..... ckbupscd(lM) 

scheduler for the uucp file transport uusched(1 M) 

SCP active mode interface scpa(7) 

SCP boards. ..... scpioctl(IM) 

script Remote rfuadmin(1 M) 

SCSI bus ...„...., — scsicnfg(lM) 

SCSI busses and peripherals scsi{7) 

server query ..... . — . nsquery{1M) 

Sharing daemon process rfudaemon(1 M) 

Sharing domain administration rfadmin{1M) 

Sharing domain and network names ............ dname(TM) 

Sharing environment » rfstop(1M) 

Sharing host password ................................ rfpasswd(1 M) 

Sharing name server query nsquery(lM) 

Sharing notification shell script rfuadmin(lM) 

Sharing resource unadv(1 M) 

Sharing ....... .. rfstart(lM) 

Sharing user and group mapping ldload(1 M) 

shell script rfuadmin(lM) 

shut down system, change system state shutdown(1 M) 
shutacct(IM) startup(IM) turnacct(IM) ......... prctmp(1M) 

software ctinstal!(1 M) 

speed, and line discipline getty(IM) 

speed, and line discipline _ uugefty(tM) 

spool directory clean- up uucleanup(IM) 

spooling system Ipadmin(l M) 

start Remote File Sharing rfstart(1 M} 

startup(IM) tumacct(1M} prdaiiy(IM) prctmp(IM) 

statistics for a file system ff(1M) 

status „ fsstat(1M) 

stop the operating system rcO(1M) 

stop the Remote File Sharing ristop{1M) 



Index 8 



UP- 13529 



Permuted Index 



open any minor device on a 



tracing interface to 

Transport Interface cooperating 
print 

processes using a file or file 

update the 
become 

add 

halt(1M) shut down 
read crash dump 
establish mount 
recover files from a backup 
initialization 
general 
controlling 
administration Remote 
administration Remote 
discipline set 
discipline set 
virtual 



compare or print out 
copy file systems for optimal access 
merge or add 
print STREAMS 
to STREAMS error logging and event 
STREAMS module 
file 

the scheduler for the uucp file 
debugging on 
runacct(lM) shutacct{1M) startups M) 
discipline set terminal 
discipline set terminal 

file systems 
resource 
unllnk(1M) link and 
directories 
umountall{1M) mount, 
forced 



summarize disk 
print 

Remote File Sharing 
generate disk accounting data by 
become super-user or another 
identify processes 
check the 
the scheduler for the 



STREAMS driver clone(7) 

STREAMS error logger cleanup program ... strclean{lM) 

STREAMS error logger daemon strerr(lM) 

STREAMS error logging and event iog{7) 

STREAMS loctl commands streamio(7) 

STREAMS module timod{7) 

STREAMS trace messages ........... strace(lM) 

structure identify ...... fuser(lM) 

summarize disk usage du{*lM) 

super block ..... sync(1M) 

super-user or another user su(1M) 

swap administrative interface swap(lM) 

symbols to kemat debugger mkdbsym(lM) 

system, change system state shutdown^ M) 

table cdt(lM) 

table selmnt(lM) 

tape frecjlM) 

tellnlt(IM) process control init(tM) 

terminal interface termio{7) 

terminal interface tty(7) 

Terminal service database tsdbadm(lM} 

Terminal service limits ,. tsllmit(IM) 

terminal type, modes, speed, and line getty(1M) 

terminal type, modes, speed, and line uugetty{1M) 

terminal „..„., „. vt(7) 

terminate the error-logging daemon errstop(IM) 

terminfo compiler ................... tic(1M) 

terminfo descriptions infocmp(IM) 

time ~. dcopy(1M) 

total accounting files acctmerg(IM) 

trace messages strace(lM) 

tracing interface log(7) 

Transport Interface cooperating timodfj) 

transport program for the uucp system ......... uuclco(1M) 

transport program .......... uusched(lM) 

try to contact remote system with Uutry(1M) 

tumacct(1M} prdaily(IM) prtacct(lM) prctmp(1M) 

type, modes, speed, and line getty(lM) 

type, modes, speed, and line uugetty(lM) 

umount(1M) mount(1M) 

umountall(lM) mount, unmount multiple ... mountall(IM) 

unadvertise a Remote File Sharing unadv(lM) 

unlink files and directories . link(1M) 

unlink(1M) link and unlink files and link(lM) 

unmount multiple file systems mountati(lM) 

unmount of an advertised resource fumount(IM) 

update the master file masterupd(tM) 

update the super block sync(iM) 

uramdisk(7) RAM disk drivers ramdisk(7) 

usage du(lM) 

user and group lOs and names id{1 M) 

user and group mapping , idfoad(1M) 

user ID diskusg(IM) 

user ..... — su(1M) 

using a file or file structure fuser(1M) 

uucp directories and permissions file uucheck(IM) 

uucp file transport program uusched(IM) 
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uucp spool directory clean-up ... — uucteanup(1 M) 

file transport program for the uucp system .... — uucico(lM) 

set up default values in CMOS RAM . cramsetup{lM) 

virtual terminal vt(7) 

who is doing what . whodo(IM) 

who is doing what — . whodo(1M) 



Index 10 UP-13529 



INTRO(IM) 



NAME 

inlro - introduction to maintenance commands and application 
programs 

DESCRIPTION 

This section describes, in alphabetical order, commands that 
are used chiefly for system maintenance and administration 
purposes. The commands in this section should be used 
along with those listed in Section 1 of the User's Reference 
Manual and Sections 1, 2, 3, 4, and 5 of the Programmer's 
Reference Manual. References of the form name(\), (2), (3), 
(4) and (5) refer to entries in the above manuals. References 
of the form name (7) refer to entries in this manual. Refer- 
ences of the form name(#B) refer to entries in the U 6000 
Series NET-6000 Operations, Administration, and Programming 
Reference Manual. 

COMMAND SYNTAX 

Unless otherwise noted, commands described in this section 
accept options and other arguments according to the follow- 
ing syntax: 

name [ option {s) ] [ cmdarg{s) ] 

where: 

name 

option 



noargletter 
argletter 
optarg 
cmdarg 



SEE ALSO 

getopt(1) in the User's Reference Manual. 
getopt(3C) in the Programmer's Reference Manual. 
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is the name of an executable file. 

- noargletter {s) or, 
• argletter < > optarg 
where < > is optional white space. 

is a single letter representing an option without 
an argument. 

is a single letter representing an option requiring 
an argument, 

is an argument (character string) satisfying the 
preceding argletter. 

is a path name (or other command argument) 
not beginning with - or, - by itself indicating the 
standard input. 
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DIAGNOSTICS 

Upon termination, each command returns two bytes of status, 
one supplied by the system and giving the cause for termina- 
tion, and (in the case of "normal" termination) one supplied by 
the program [see wait {2) and ex/f(2)]. The former byte is 0 
for normal termination; the latter is customarily 0 for success- 
ful execution and non-zero to indicate troubles such as errone- 
ous parameters, bad or inaccessible data, or other inability to 
cope with the task at hand. It is called variously "exit code", 
"exit status", or "return code", and is described only where 
special conventions are involved. 

BUGS 

Regrettably, not all commands adhere to the aforementioned 
syntax. 
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NAME 

accept, reject - allow or prevent LP requests 

SYNOPSIS 

/usr/iib/accept destinations 

/usr/lib/reject [ -r [ reason ] ] destinations 
DESCRIPTION 

Accept allows /p(1) to accept requests for the named destina- 
tions. A destination can be either a line printer (LP) or a class 
of printers. Use ipstat (1) to find the status of destinations. 

Reject prevents /p(1) from accepting requests for the named 
destinations. A destination can be either a printer or a class 
of printers. Use Ipstat (1) to find the status of destinations. 
The following option is useful with reject. 

-r[ reason] Associates a reason with preventing Ip from 
accepting requests. This reason applies to all 
printers mentioned up to the next -r option. 
Reason is reported by Ip when users direct 
requests to the named destinations and by 
Ipstat (1). If the -r option is not present or the -r 
option is given without a reason, then a default 
reason will be used. 

FILES 

/usr/spool/lp/* 

SEE ALSO 

Ipadmin(lM), lpsched(1M). 

enable(1), lp{1), lpstat(1) in the User's Reference Manual. 
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NAME 

acctdisk, acctdusg, accton, acctwtmp - overview of accounting 
and miscellaneous accounting commands 

SYNOPSIS 

Aisr/lib/acct/acctdisk 

/usr/Hb/acct/acctdusg [ -u file ] [ -p file ] 
/usr/lib/acct/accton [ file ] 
/usr/lib/acct/acctwtmp "reason" 
DESCRIPTION 

Accounting software is structured as a set of tools (consisting 
of both C programs and shell procedures) that can be used to 
build accounting systems. Acctsh (1M) describes the set of 
shell procedures built on top of the C programs. 

Connect time accounting is handled by various programs that 
write records into /etc/utmp/, as described in utmp{4). The 
programs described in accfcon (1M) convert this file into ses- 
sion and charging records, which are then summarized by 
acctmerg (1M). 

Process accounting is performed by the System V system ker- 
nel. Upon termination of a process, one record per process is 
written to a file (normally /usr/adm/pacct). The programs in 
acctprc{1M) summarize this data for charging purposes; 
acctcms^M) is used to summarize command usage. Current 
process data may be examined using acctcom{1). 

Process accounting and connect time accounting [or any 
accounting records in the format described in acct(4)] can be 
merged and summarized into total accounting records by 
acctmerg [see tacct format in accf(4)]. Prtacct [see 
acctsh (1M)] is used to format any or all accounting records. 

Acctdisk reads lines that contain user ID, login name, and 
number of disk blocks and converts them to total accounting 
records that can be merged with other accounting records. 

Acctdusg reads its standard input (usually from find I -print) 
and computes disk resource consumption (including indirect 
blocks) by login. If -u is given, records consisting of those file 
names for which acctdusg charges no one are placed in file (a 
potential source for finding users trying to avoid disk charges). 
If -p is given, file is the name of the password file. This option 
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is not needed if the password file is /etc/passwd. (See 
diskusg{lM) for more details.) 

Accton alone turns process accounting off. If file is given, it 
must be the name of an existing file, to which the kernel 
appends process accounting records [see accf(2) and 
accf(4)]. 

Acctwtmp writes a utmp{4) record to its standard output. The 
record contains the current time and a string of characters 
that describe the reason. A record type of ACCOUNTING is 
assigned [see utmp(4)]. Reason must be a string of 11 or 
fewer characters, numbers, $, or spaces. For example, the 
following are suggestions for use in reboot and shutdown pro- 
cedures, respectively: 

acctwtmp *uname* » /etc/wtmp 
acctwtmp "file save" » /etc/wtmp 

FILES 

/etc/passwd used for login name to user ID conversions 

/usr/lib/acct holds ail accounting commands listed in 
section 1 of this manual 

/usr/adm/pacct current process accounting file 

/etc/wtmp login/logoff history file 

SEE ALSO 

acctcms(IM), acctcon(IM), acctmerg(IM), acctprc(IM), 

acctsh(1M), diskusg(lM), runacct(IM). 

acct(2), acct(4), utmp(4) in the Programmer's Reference 

Manual. 

acctcom(1) in the User's Reference Manual. 
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NAME 

acctcms - command summary from per-process accounting 
records 

SYNOPSIS 

/usr/lib/acct/acctcms [ options ] files 

DESCRIPTION 

Acctcms reads one or more files, normally in the form 
described in acct{4). It adds all records for processes that 
executed identically-named commands, sorts them, and writes 
them to the standard output, normally using an internal sum- 
mary format. The options are: 

-a Print output in ASCII rather than in the internal summary 
format. The output includes command name, number of 
times executed, total kcore-minutes, total CPU minutes, 
total real minutes, mean size (in K), mean CPU minutes 
per invocation, "hog factor" , characters transferred, and 
blocks read and written, as in acctcom("\). Output is nor- 
mally sorted by total kcore-minutes. 

-c Sort by total CPU time, rather than total kcore-minutes. 

-j Combine all commands invoked only once under 
"***other". 

-n Sort by number of command invocations. 

-s Any file names encountered hereafter are already in inter- 
nal summary format. 

-t Process all records as total accounting records. The 
default internal summary format splits each field into 
prime and non-prime time parts. This option combines 
the prime and non- prime time parts into a single field that 
is the total of both, and provides upward compatibility 
with old style acctcms internal summary format records. 

The following options may be used only with the -a option. 

-p Output a prime- time-only command summary. 

-o Output a non-prime (offshift) time only command sum- 
mary. 

When -p and -o are used together, a combination prime and 
non-prime time report is produced. All the output summaries 
will be total usage except number of times executed, CPU 
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minutes, and real minutes, which will be split into prime and 
non- prime. 

A typical sequence for performing daily command accounting 
and for maintaining a running total is: 

acctcms file ... >today 

cp total previoustotal 

acctcms -s today previoustotal >total 

acctcms - a - s today 

SEE ALSO 

acct(lM), acctcon(IM), acctmerg(IM), acctprc(lM), 
acctsh(1M), runacct(IM). 

acct(2), acct(4), utmp(4) in the Programmer's Reference 
Manual. 

acctcom(1) in the User's Reference Manual. 
BUGS 

Unpredictable output results if -t is used on new style internal 
summary format files, or if it is not used with old style internal 
summary format files. 
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NAME 

acctconl, acctcon2 - connect- time accounting 

SYNOPSIS 

/usr/lib/acct/acctcon1 [ options ] 

/usr/lib/acct/acctcon2 

DESCRIPTION 

Accfcont converts a sequence of login/logoff records read 
from its standard input to a sequence of records, one per 
login session. Its input should normally be redirected from 
/etc/wtmp. Its output is ASCII, giving device, user ID, login 
name, prime connect time (seconds), non-prime connect time 
(seconds), session starting time (numeric), and starting date 
and time. The options are: 

•p Print input only, showing line name, login name, and 
time (in both numeric and date/time formats). 

-t Acctconl maintains a list of lines on which users are 
logged in. When it reaches the end of its input, it 
emits a session record for each line that still appears to 
be active. It normally assumes that its input is a 
current file, so that it uses the current time as the end- 
ing time for each session still in progress. The -t flag 
causes it to use, instead, the last time found in its 
input, thus assuring reasonable and repeatable 
numbers for non-current files. 

-I file File is created to contain a summary of line usage 
showing line name, number of minutes used, percen- 
tage of total elapsed time used, number of sessions 
charged, number of logins, and number of logoffs. 
This file helps track line usage, identify bad lines, and 
find software and hardware oddities. Hang-up, termi- 
nation of login (1) and termination of the login shell 
each generate logoff records, so that the number of 
logoffs is often three to four times the number of ses- 
sions. See init (1 M) and utmp (4) . 

-o file File is filled with an overall record for the accounting 
period, giving starting time, ending time, number of 
reboots, and number of date changes. 
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Acctcon2 expects as input a sequence of login session 
records and converts them into total accounting records [see 
tacct format in acct (4)]. 

EXAMPLES 

These commands are typically used as shown below. The file 
ctmp is created only for the use of acctprc(1 M) commands: 

acctcon! -t -1 lineuse -o reboots <wtmp ! sort +1n +2 >ctmp 
acctcon2 <ctmp J acctmerg >ctacct 

FILES 

/etc/wtmp 

SEE ALSO 

acct(1M), acctcms(IM), acctcom(l), acctmerg{1M), 
acctprc{1M), acctsh(1M), init(1M), login(1), runacct(IM). 
acct(2), acct(4), utmp(4) in the Programmer's Reference 
Manual, 

BUGS 

The line usage report is confused by date changes. 
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NAME 

acctmerg - merge or add total accounting files 
SYNOPSIS 

/usr/lib/acct/acctmerg [ options ] [ file ] ... 
DESCRIPTION 

Acctmerg reads its standard input and up to nine additional 
files, ail in the tacct format [see accf{4)], or an ASCII version 
thereof. It merges these inputs by adding records whose 
keys {normally user ID and name) are identical, and expects 
the inputs to be sorted on those keys. Options are: 

-a Produce output in ASCII version of tacct. 

-I Input files are in ASCII version of tacct. 

-p Print input with no processing. 

-t Produce a single record that totals all input. 

-u Summarize by user ID, rather than user ID and name. 

-v Produce output in verbose ASCII format, with more pre- 
cise notation for floating point numbers. 

EXAMPLES 

The following sequence is useful for making "repairs" to any 
file kept in this format: 

acctmerg -v <f i lei >f i1e2 

edit file2 as desired . , . 

acctmerg -a <f ile2 >f(1e1 

SEE ALSO 

acct(1M), acctcms(IM), acctcom(1), acctcon(lM), acctprc(IM), 
acctsh(1M), runacct(IM). 

acct(2), acct(4), utmp(4) in the Programmer's Reference 
Manual. 
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NAME 

acctprd , acctprc2 - process accounting 

SYNOPSIS 

/usr/lib/acct/acctprd [ ctmp ] 

/usr/l i b/acct/acctprc2 

DESCRIPTION 

Acctprd reads input in the form described by acct(4) t adds 
login names corresponding to user IDs, then writes for each 
process an ASCII line giving user IDs, login name, prime CPU 
time (tics), non-prime CPU time (tics), and mean memory size 
(in memory segment units). If ctmp is given, it is expected to 
contain a list of login sessions, in the form described in 
acctcon{1M), sorted by user ID and login name. If this file is 
not supplied, it obtains login names from the password file. 
The information in ctmp helps it distinguish among different 
login names that share the same user ID. 

Acctprc2 reads records in the form written by acctprd , sum- 
marizes them by user ID and name, then writes the sorted 
summaries to the standard output as total accounting records. 

These commands are typically used as shown below: 

acctprd ctmp </usr/adm/pacct ! acctprc2 >ptacct 

FILES 

/etc/passwd 

SEE ALSO 

acct(1M), acctcms(IM), acctcom{1), acctcon(IM), 

acctmerg(IM), acctsh(1M), cron(1M), runacct(IM). 

acct(2), acct(4), utmp(4) in the Programmer's Reference 

Manual. 

BUGS 

Although it is possible to distinguish among login names that 
share user IDs for commands run normally, it is difficult to do 
this for those commands run from cron (1M), for example. 
More precise conversion can be done by faking login sessions 
on the console via the acctwtmp program in accf (1M). 

NOTE 

A memory segment of the mean memory size is a unit of 
measure for the number of bytes in a logical memory seg- 
ment on a particular processor. For example, on 80386-based 
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systems, such as the 6000/50, this measure would be in 4- 
kilobyte units. 
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NAME 

chargefee, ckpacct, dodisk, lastlogin, monacct, nulladm, 
prctmp, prdaily, prtacct, runacct, shutacct, startup, turnacct - 
shell procedures for accounting 

SYNOPSIS 

/usr/lib/acct/chargefee login-name number 

/usr/iib/acct/ckpacct [blocks] 

/usr/iib/acct/dodisk [ -o ] [ files ... ] 

/usr/lib/acct/lastlogin 

/usr/lib/acct/monacct number 

/usr/lib/acct/nulladm file 

/usr/lib/acct/prctmp 

Aisr/Iib/acct/prdaily [ -I J [ -c ] [ mmdd j 
/usr/lib/acct/prtacct file [ "heading" ] 
/usr/lib/acct/runacct [ mmdd ] [ mmdd state j 
/usr/lib/acct/shutacct [ "reason" ] 
/usr/lib/acct/startup 

/usr/lib/acct/turnacct on j off | switch 
DESCRIPTION 

Chargefee can be invoked to charge a number of units to 
login-name. A record is written to /usr/adm/fee, to be 
merged with other accounting records during the night. 

Ckpacct should be initiated via cron (1M). It periodically 
checks the size of /usr/adm/pacct If the size exceeds 
blocks, 1000 by default, turnacct will be invoked with argu- 
ment switch. If the number of free 512-byte disk blocks in the 
/usr file system falls below 500, ckpacct will automatically turn 
off the collection of process accounting records via the off 
argument to turnacct. When at least this number of blocks is 
restored, the accounting will be activated again. This feature 
is sensitive to the frequency at which ckpacct is executed, 
usually by cron. 

Dodisk should be invoked by cron to perform the disk 
accounting functions. By default, it will do disk accounting on 
the special files in /etc/checklist. If the -o flag is used, it will 
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do a slower version of disk accounting by login directory. 
F/7es specify the one or more filesystem names where disk 
accounting will be done. If files are used, disk accounting will 
be done on these fiiesystems only. If the -o flag is used, files 
should be mount points of mounted filesystem. If omitted, 
they should be the special file names of mountable fiiesys- 
tems. 

Lastlogin is invoked by runacct to update 
/usr/adm/acct/sum/loginlog, which shows the last date on 
which each person logged in. 

Monacct should be invoked once each month or each 
accounting period. Number indicates which month or period it 
is. If number is not given, it defaults to the current month 
(01-12). This default is useful if monacct is to executed via 
cron(1M) on the first day of each month. Monacct creates 
summary files in /usr/adm/acct/fiscal and restarts summary 
files in /usr/adm/acct/sum. 

Nulladm creates file with mode 664 and insures that owner 
and group are adm. It is called by various accounting shell 
procedures. 

Prctmp can be used to print the session record file (normally 
/usr/adm/acct/nite/ctmp created by acctconl [see 
accfcon(IM)]. 

Prdaily is invoked by runacct to format a report of the previ- 
ous day's accounting data. The report resides in 
/usr/adm/accVsurn/rprtmmdo' where mmdd is the month and 
day of the report. The current daily accounting reports may 
be printed by typing prdaily. Previous days' accounting 
reports can be printed by using the mmdd option and specify- 
ing the exact report date desired. The -I flag prints a report 
by login ID of exceptional usage for the specified date. Previ- 
ous daily reports are cleaned up and therefore inaccessible 
after each invocation of monacct. The -c flag prints a report 
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of exceptional resource usage by command and may be used 
on current day's accounting data only. 

Prtacct can be used to format and print any total accounting 
(tacct) file. 

Runacct performs the accumulation of connect, process, fee, 
and disk accounting on a daily basis. It also creates sum- 
maries of command usage. For more information, see 
runacct (1M), 

Shutacct should be invoked during a system shutdown (usu- 
ally in /etc/shutdown) to turn process accounting off and 
append a "reason" record to /etc/wtmp. 

The BACCT entries in the file /usr/spool/cron/crontabs/adm 
must be present to turn the accounting on whenever the sys- 
tem is brought up at run level 2. 

Tumacct is an interface to accton [see acct (1M)] to turn pro- 
cess accounting on or off. The switch argument turns 
accounting off, moves the current /usr/adm/pacct to the next 
free name in /usr/adm/pacct/ncr (where incr is a number 
starting with 1 and incrementing by one for each additional 
pacct file), then turns accounting back on again. This pro- 
cedure is called by ckpacct and thus can be taken care of by 
the cron and used to keep pacct to a reasonable size. 

FILES 

/usr/spool/cron/crontabs/adm 

cron file which determines the interval 
for system accounting 

/usr/adm/fee accumulator for fees 
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/usr/adm/pacct 
/usr/adm/pacct* 



current file for per-process accounting 



used if pacct gets large and during 
execution of daily accounting pro- 
cedure 



/etc/wtmp 



login/logoff summary 



/usr/lib/acct/ptelus.awk contains the limits for exceptional 

usage by login ID 

/usr/lib/acct/ptecms.awk 

contains the limits for exceptional 
usage by command name 

/usr/adm/acct/nite working directory 

/usr/lib/acct holds all accounting commands listed 



/usr/adm/acct/sum summary directory, should be saved 
SEE ALSO 

acct(lM), acctcms(IM), acctcom(1), acctcon(IM), 
acctmerg(1M) ( acctprc(lM), cron(1M) ( diskusg(IM), 
runacct(lM). 

acct(2), acct(4), utmp{4) in the Programmer's Reference 
Manual, 
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NAME 

adv - advertise a directory for remote access 
SYNOPSIS 

adv [ -r ] [ -d description ] resource pathname 
[ clients ... ] 

adv -m resource -d description j [ clients ... ] 
adv -m resource [ -d description ] J clients ... 
adv 

DESCRIPTION 

Adv is the Remote File Sharing command used to make a 
resource from one computer available for use on other com- 
puters. The machine that advertises the resource is called the 
server, while computers that mount and use the resource are 
clients, [See mount (1M).j (A resource represents a directory, 
which could contain files, subdirectories, named pipes, and 
devices.) 

There are three ways adv is used: (1) to advertise the direc- 
tory pathname under the name resource so it is available to 
Remote File Sharing clients', (2) to modify client and descrip- 
tion fields for currently advertised resources; or {3) to print a 
list of all locally-advertised resources. 

The following options are available: 

-r Restricts access to the resource to a read- 

only basis. The default is read-write access. 

-d description Provides brief textual information about the 
advertised resource, description is a single 
argument surrounded by double quotes (") 
and has a maximum length of 32 characters. 

resource This is the symbolic name used by the server 
and all authorized clients to identify the 
resource. It is limited to a maximum of 14 
characters and must be different from every 
other resource name in the domain. All char- 
acters must be printable ASCII characters but 
must not include periods (.), slashes (/), or 
white space. 
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pathname This is the local pathname of the advertised 
resource. It is limited to a maximum of 64 
characters. This pathname cannot be the 
mount point of a remote resource and it can 
only be advertised under one resource name. 

clients These are the names of all clients that are 

authorized to remotely mount the resource. 
The default is that all machines that can con- 
nect to the server are authorized to access 
the resource. Valid input is of the form 
nodename, domain.nodename , domain,, or an 
alias that represents a list of client names. A 
domain name must be followed by a period (.) 
to distinguish it from a host name. The 
aliases are defined in /etc/host.a!ias and 
must conform to the alias capability in 
ma//x{1), 

-m resource This option modifies information for a 
resource that has already been advertised. 
The resource is identified by a resource name. 
Only the clients and description fields can be 
modified. (To change the pathname , resource 
name, or read/write permissions, you must 
unadvertise and re-advertise the resource.) 

When used with no options, adv displays all local resources 
that have been advertised; this includes the resource name, 
the pathname, the description, the read-write status, and the 
list of authorized clients. The resource field has a fixed length 
of 14 characters; all others are of variable length. Fields are 
separated by two white spaces, double quotes (") surround 
the description, and blank lines separate each resource entry. 

This command may be used without options by any user; oth- 
erwise it is restricted to the super-user. 

Remote File Sharing must be running before adv can be used 
to advertise or modify a resource entry. 

EXIT STATUS 

If there is at least one syntactically valid entry in the clients 
field, a warning will be issued for each invalid entry and the 
command will return a successful exit status. A non-zero exit 
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status will be returned if the command fails, 
ERRORS 

If (1) the network is not up and running, (2) pathname is not a 
directory, (3) pathname isn't on a file system mounted locally, 
or {4) there is at least one entry in the clients field but none 
are syntactically valid, an error message will be sent to stan- 
dard error. 

FILES 

/etc/host.alias 

SEE ALSO 

mount(1M), rfstart(IM), unadv(1M). 
mailx(1) in the User's Reference Manual. 
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NAME 

bcopy - interactive block copy 

SYNOPSIS 
/etc/bcopy 

DESCRIPTION 

Bcopy copies from and to files starting at arbitrary biock (512- 
byte) boundaries. 

Bcopy asks following questions: 

to: (you name the file or device to be copied to). 

offset: (you provide the starting "to" block number). 

from: (you name the file or device to be copied from). 

offset: (you provide the starting "from" block number). 

count: (you reply with the number of blocks to be 
copied). 

After count is exhausted, the from question is repeated (giv- 
ing you a chance to concatenate blocks at the 
to + offset + count location). If you answer from with a car- 
riage return, everything starts over. 

Two consecutive carriage returns terminate bcopy. 

SEE ALSO 

cpio(l), dd(l). 
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NAME 

brc, bcheckrc, powerfail - system initialization procedures 

SYNOPSIS 
/etc/brc 

/etc/bcheckrc 

/etc/powerfail 

DESCRIPTION 

These shell procedures {except powerfail) are executed via 
entries in /etc/bootwait (an entry in /etc/inittab) by ;V?/f(1M) 
whenever the system is booted (or rebooted). They are exe- 
cuted at boot time. Powerfail is executed whenever a system 
power failure is detected. 

The bcheckrc procedure checks the status of the root file sys- 
tem. If the root file system is found to be bad, bcheckrc 
repairs it by calling fsck (1M). If fsck fails, bcheckrc switches 
the system to state 5, which is normally 6000/50 administrator 
mode. Bcheckrc also sets the date to the date currently in 
the real-time clock. 

The brc procedure clears the mounted file system table, 
/etc/mnttab, and puts the entry for the root file system into 
the mount table. 

The powerfail procedure is invoked when the system detects a 
power failure condition. It calls uadmin to bring down the sys- 
tem gracefully. 

After /etc/bootwait has been executed, init checks for the init- 
default value in /etc/inittab. This value tells init the run level 
in which to place the system. Since initdefault is initally set to 
2, the system will be placed in the multi-user state via the 
/etc/rc2 procedure. 

Note that bcheckrc should always be executed before brc. 
Also, these shell procedures may be used for several run level 
states. 
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SEE ALSO 

fsck(1M), hinv(1M), init(1M), rcO(1M), rc2(1M), shutdown (1M). 

date(1), who(1) in the User's Reference Manual. 

inittab(4), mnttab(4) in the Programmer's Reference Manual, 
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NAME 

captoinfo - convert a termcap description into a terminfo 
description 

SYNOPSIS 

captoinfo [ -v ... ] [ -1 ] [ -w width ] file ... 
DESCRIPTION 

Captoinfo looks in file for termcap descriptions. For each one 
found, an equivalent terminfo (4) description is written to stan- 
dard output, along with any comments found. A description 
which is expressed as relative to another description (as speci- 
fied in the termcap tc = field) will be reduced to the minimum 
superset before being output. 

If no file is given, then the environment variable TERMCAP is 
used for the filename or entry. If TERMCAP is a full path- 
name to a file, only the terminal whose name is specified in 
the environment variable TERM is extracted from that file. If 
the environment variable TERMCAP is not set, then the file 
/etc/termcap is read. 

The options are as follows: 

•v Print tracing information on standard error as the pro- 
gram runs. Specifying additional -v options will cause 
more detailed information to be printed. 

-1 Cause the fields to print out one to a line. Otherwise, the 
fields will be printed several to a line to a maximum width 
of 60 characters. 

-w Change the output to width characters. 

FILES 

/usr/lib/terminfo/?/* compiled terminal description database 
CAVEATS 

Certain termcap defaults are assumed to be true. For exam- 
ple, the bell character (terminfo bet) is assumed to be ~G. 
The linefeed capability (termcap nl) is assumed to be the 
same for both cursor _down and scroll forward (terminfo cudl 
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and ind, respectively.) Padding information is assumed to 
belong at the end of the string. 

The algorithm used to expand parameterized information for 
termcap fields such as cursor _position {termcap cm, terminfo 
cup) will sometimes produce a string which, though technically 
correct, may not be optimal. In particular, the rarely used 
termcap operation %n will produce strings that are especially 
long. Most occurrences of these non-optima! strings will be 
flagged with a warning message and may need to be recoded 
by hand. 

The short two-letter name at the beginning of the list of 
names in a termcap entry, a hold-over from an earlier version 
of the UNIX* system, has been removed. 

DIAGNOSTICS 

tgetent failed with return code n (reason). 

The termcap entry is not valid. In particular, check for an 
invalid tc = entry. 

unknown fype given for the termcap code cc. 

The termcap description had an entry for cc whose type 
was not boolean, numeric or string. 

wrong type given for the boolean (numeric, string) 
termcap code cc. 

The boolean termcap entry cc was entered as a numeric 

or string capability. 

the boolean (numeric, string) termcap code cc is 
not a valid name-. 

An unknown termcap code was specified. 

fgefenf failed on TERM = term. 

The terminal type specified could not be found in the 
termcap file. 



*UNIX is a registered trademark of AT&T in the USA and 
other countries. Portions of the Unisys System V Operating 
System are derived from the AT&T UNIX V.3 release. 
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TERM = term: cap cc (info ii) is NULL: REMOVED 

The termcap code was specified as a null string. The 
correct way to cancel an entry is with an @, as in :bs@:. 
Giving a null string could cause incorrect assumptions to 
be made by the software which uses fermcap or terminfo. 

a function key for cc was specified, but it already 

has the value vv. 

When parsing the ko capability, the key cc was specified 
as having the same value as the capability cc, but the key 
cc already had a value assigned to it. 

the unknown termcap name cc was specified in the ko 
termcap capability. 

A key was specified in the ko capability which could not 

be handled. 

the vi character v (info ii) has the value xx, 

but ma gives n. 

The ma capability specified a function key with a value dif- 
ferent from that specified in another setting of the same 
key. 

the unknown vi key v was specified in the ma 
termcap capability. 

A w'(1) key unknown to captoinfo was specified in the ma 

capability. 

Warning: termcap sg (nn) and termcap ug (nn) had 
different values. 

Terminfo assumes that the sg (now xmc) and ug values 

were the same. 

Warning: the siring produced for ii may be inefficient. 

The parameterized string being created should be rewrit- 
ten by hand. 

Null termname given. 

The terminal type was null. This is given if the environ- 
ment variable TERM is not set or is null. 

cannot open file for reading. 

The specified file could not be opened. 
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SEE ALSO 

infocmp(IM), tic(1M). 

curses(3X), terminfo(4) in the Programmer's Reference 
Manual. 

"curses/terminfo" in the System V Operating System 
Programmer's Guide. 

NOTES 

Captoinfo should be used to convert termcap entries to ter- 
minfo(4) entries because the termcap database (from earlier 
versions of UNIX System V) may not be supplied in future 
releases. 
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NAME 

cdc - change the delta commentary of an SCCS delta 
SYNOPSIS 

cdc -rSID [ -m [ mrlist ] ] [ -y [ comment ] ] tiles 
DESCRIPTION 

Cdc changes the delta commentary, for the SID (SCCS IDen- 
tification string) specified by the -r keyletter, of each named 
SCCS file. 

Delta commentary is defined to be the Modification Request 
(MR) and comment information normally specified via the 
delta{*\) command (-m and -y keyletters). 

If a directory is named, cdc behaves as though each file in the 
directory were specified as a named file, except that non- 
SCCS files (last component of the path name does not begin 
with s.) and unreadable files are silently ignored. If a name 
of - is given, the standard input is read (see WARNINGS) and 
each line of the standard input is taken to be the name of an 
SCCS file to be processed. 

Arguments to cdc, which may appear in any order, consist of 
keyletter arguments and file names. 

All the described keyletter arguments apply independently to 
each named file: 

-rS/D Used to specify the SCCS /Dentification (SID) 

string of a delta for which the delta commen- 
tary is to be changed. 

-mmr//sr If the SCCS file has the v flag set [see 

admin (1)] then a list of MR numbers to be 
added and/or deleted in the delta commen- 
tary of the SID specified by the -r keyletter 
may be supplied. A null MR list has no effect. 

MR entries are added to the list of MRs in the 
same manner as that of delta (1). In order to 
delete an MR, precede the MR number with 
the character ! (see EXAMPLES). If the MR to 
be deleted is currently in the list of MRs, it is 
removed and changed into a "comment" line. 
A list of all deleted MRs is placed in the com- 
ment section of the delta commentary and 
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preceded by a comment line stating that they 
were deleted. 

If -m is not used and the standard input is a 
terminal, the prompt MRs? is issued on the 
standard output before the standard input is 
read; if the standard input is not a terminal, 
no prompt is issued. The MRs? prompt 
always precedes the comments? prompt (see 
-y keyletter). 

MRs in a list are separated by blanks and/or 
tab characters. An unescaped new-line char- 
acter terminates the MR list. 

Note that if the v flag has a value [see 
admin (1)], it is taken to be the name of a pro- 
gram (or shell procedure) which validates the 
correctness of the MR numbers. If a non-zero 
exit status is returned from the MR number 
validation program, cdc terminates and the 
delta commentary remains unchanged. 

-y [comment] Arbitrary text used to replace the commenr(s) 
already existing for the delta specified by the 
-r keyletter. The previous comments are kept 
and preceded by a comment line stating that 
they were changed. A null comment has no 
effect. 

If -y is not specified and the standard input is 
a terminal, the prompt comments? is issued 
on the standard output before the standard 
input is read; if the standard input is not a ter- 
minal, no prompt is issued. An unescaped 
new-line character terminates the comment 
text. 

Simply stated, the keyletter arguments are either (1) if you 
, made the delta, you can change its delta commentary; or (2) 
if you own the file and directory you can modify the delta 
commentary. 

EXAMPLES 

cdc -rl.6 -m"bl78- 12345 !t>177- 54321 b!79- 00001" -ytrouble 
s.f Ue 
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Adds b!78- 12345 and b!79-00001 to the MR list, removes b\77- 
54321 from the MR list, and adds the comment trouble to 
delta 1 .6 of s.file, 

cdc -rl.6 s.file 

MRs? !b1 77- 54321 bl 78- 12315 bl 79- 00001 
comments? trouble 

does the same thing. 
WARNINGS 

If SCCS file names are supplied to the cote command via the 
standard input (- on the command line), then the -m and -y 
keyletters must also be used. 

FILES 

x-file [see de/fa(1)] 
z-file [see cte/te(1)j 

SEE ALSO 

admin(l), delta(1), get(1), prs(1), sccsfile(4). 
help(1) in the User's Reference Manual. 

DIAGNOSTICS 

Use ne/p(1) for explanations. 
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NAME 

cdt - read crash dump table 

SYNOPSIS 

cdt [ -bBdDprav ] 

DESCRIPTION 

Reads the crash dump table set up by the boot ROM, and 
displays various parts of it, as specified by the command line 
options, 

•b Print the drive number of the boot device, as a decimal 
integer. 

-d Print the drive number of the dump device, as a decimal 
integer. 

-B Print the media type of the boot device. The media type 
is a single character: S (SCSI disk), T (tape), D (ST506 
disk), F (floppy). 

*D Print the media type of the dump device. 

-p Print the panic string, if the system went down due to a 
panic. 

•r Print the reason for the previous shutdown. This is actu- 
ally a brief history of the events starting from the previous 
poweron. 

-a Equivalent to -BbDdrp. 

•v Verbose mode. Prints descriptive text for each of the 
items displayed. 
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NAME 

checkfsys - check a file system on a removable disk 
SYNOPSIS 

The checkfsys command allows the user to check for and 
optionally repair a damaged file system on a removable 
disk. 

The user is asked one of the following three functions: 

check the file system 
No repairs are attempted. 

repair it interactively 

The user is informed about each instance of damage and 
asked if it should be repaired. 

repair it automatically 

The program applies a standard repair to each instance of 
damage. 

WARNING 

While automatic and interactive checks are generally success- 
ful, they can occasionally lose a file or a file's name. Files with 
content but without names are put in the /file- 
sysfem/lost+ found directory. 

If losing data is of particular concern, "check" the file system 
first to discover if it appears to be damaged. If it is damaged, 
use one of the repair mechanisms or the file system debug- 
ging utility, fsdb. 

SEE ALSO 

fsck(1M), fsdb(lM). 
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NAME 

chroot - change root directory for a command 

SYNOPSIS 

/etc/chroot newroot command 

DESCRIPTION 

Chroot causes the given command to be executed relative to 
the new root. The meaning of any initial slashes (/) in the 
path names is changed for the command and any of its child 
processes to newroof. Furthermore, upon execution, the ini- 
tial working directory is newroot. 

Notice, however, that if you redirect the output of the com- 
mand to a file: 

chroot newroot command >x 

will create the file x relative to the original root of the com- 
mand, not the new one. 

The new root path name is always relative to the current root: 
even if a chroot is currently in effect, the newroot argument is 
relative to the current root of the running process. 

This command can be run only by the super-user. 

SEE ALSO 

cd(1) in the User's Reference Manual. 

chroot(2) in the Programmer's Reference Manual. 

BUGS 

One should exercise extreme caution when referencing device 
files in the new root file system. 
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NAME 

ckbupscd - check file system backup schedule 

SYNOPSIS 

/etc/ckbupscd [ -m ] 

DESCRIPTION 

Ckbupscd consults the file /etc/bupsched and prints the file 
system lists from lines with date and time specifications 
matching the current time. If the -m flag is present an intro- 
ductory message in the output is suppressed so that only the 
file system lists are printed. Entries in the /etc/bupsched file 
are printed under the control of cron. 

The System Administration commands bupschedf schedcheck 
are provided to review and edit the /etc/bupsched file. 

The file /etc/bupsched should contain lines of 4 or more 
fields, separated by spaces or tabs. The first 3 fields (the 
schedule fields) specify a range of dates and times. The rest 
of the fields constitute a list of names of file systems to be 
printed if ckbupscd is run at some time within the range given 
by the schedule fields. The general format is: 

time[,time] day[,day] month [.month] fsyslist 

where: 

time Specifies an hour of the day (0 through 23), match- 
ing any time within that hour, or an exact time of 
day {0:00 through 23:59). 

day Specifies a day of the week {sun through sat) or 
day of the month (7 through 37). 

month Specifies the month in which the time and day 
fields are valid. Legal values are the month 
numbers {7 through 12). 

fsyslist The rest of the line is taken to be a file system list 
to print. 

Multiple time, day, and month specifications may be 
separated by commas, in which case they are evaluated left to 
right. 

An asterisk {*) always matches the current value for that field. 
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A line beginning with a sharp sign (#) is interpretted as a com- 
ment and ignored. 

The longest line allowed (including continuations) is 1024 char- 
acters. 

EXAMPLES 

The following are examples of lines which could appear in the 
/etc/bupscned file. 

06:00-09:00 fri 1,2,3,1,5,6,7,8,9,10,11 /appllc 

Prints the file system name lapplic if ckbupscd is run between 
6:00am and 9:00am any Friday during any month except 
December. 

00:00-06:00,16:00-23:59 1,2,3,4,5,6,7 1,8 / 

Prints a reminder to backup the root (/) file system if 
ckbupscd is run between the times of 4:00pm and 6:00am 
during the first week of August or January. 

FILES 

/etc/bupsched specification file containing times and file 
system to back up 

SEE ALSO 

cron(1M). 

echo(1), sh{1), sysadm(1) in the User's Reference Manual. 
BUGS 

Ckbupscd will report file systems due for backup if invoked 
any time in the window. It does not know that backups may 
have just been taken. 
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NAME 

clri - clear i-node 

SYNOPSIS 

/etc/clri special i-number ... 

DESCRIPTION 

Clri writes nulls on the 64 bytes at offset /- number from the 
start of the i-node list. This effectively eliminates the i-node at 
that address. Special is the device name on which a file sys- 
tem has been defined. After clri is executed, any blocks in the 
affected file will show up as "not accounted for" when 
fsck (1M) is run against the file-system. The i-node may be 
allocated to a new file. 

Read and write permission is required on the specified special 
device. 

This command is used to remove a file which appears in no 
directory; that is, to get rid of a file which cannot be removed 
with the rm command. 

SEE ALSO 

fsck(1M), fsdb(1M), ncheck(lM). 

fs(4) in the Programmer's Reference Manual. 

rm(1) in the User's Reference Manual, 

WARNINGS 

If the file is open for writing, clri will not work. The file system 
containing the file should be NOT mounted. 

If clri is used on the i-node number of a file that does appear 
in a directory, it is imperative to remove the entry in the direc- 
tory at once, since the i-node may be allocated to a new file. 
The old directory entry, if not removed, continues to point to 
the same file. This sounds like a link, but does not work like 
one. Removing the old entry destroys the new file. 
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NAME 

config - configure a 6000/50 system 
SYNOPSIS 

/etc/config [ -c file ] [ -h file ] [ -m file ] dfile 
DESCRIPTION 

Config is a program that takes a description of a 6000/50 sys- 
tem, generates a configuration table file, and generates a 
hardware interface file. The configuration table file is a C pro- 
gram defining the configuration tables for the various devices 
on the system. The hardware interface file provides informa- 
tion regarding the interface between the hardware and device 
handlers. 

The options are as follows: 

-c file Specifies the name of the configuration table file; 
conf.c is the default name. 

-h file Specifies the name of the configuration header fife; 
config. h is the default. 

-m file Specifies the name of the file that contains all the 
information regarding supported devices; 
/etc/master is the default name. This file is sup- 
plied with the 6000/50 system and should not be 
modified unless the user fully understands its con- 
struction. 

The user must supply df/7e; it must contain device information 
for the user's system. This file is divided into two parts. The 
first part contains physical device specifications. The second 
part contains system-dependent information. Any line with an 
asterisk (*) in column 1 is a comment. 

First Part of dfile 
Each line contains one field: 

devname 

where devname is the name of the device (as it appears in the 
/etc/master device table). 

Second Part of dfile 

The second part contains two different types of lines. Note 
that all specifications of this part are required, although their 
order is arbitrary. 
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1 . Root I pipe I swap device specification 

Three lines of three fields each: 

root devname minor 
pipe devname minor 
swap devname minor 

where minor is the minor device number (in decimal) of 
the slice on the fixed disk. 

2. Parameter specification 

There are any number of lines of two fields each, chosen 
from the following list. Number is decimal. This list is not 
complete; parameters not on the list either must not be 
changed or have no effect. 

maxusers number 

/* maximum number of users logged */ 







/* on at any one time */ 


buffers 


number 


/* number of 1021- byte file */ 






/* system caching buffers */ 


dmmxsz 


number 


/* maximum number of pages */ 






/* per loadable driver */ 


i nodes 


number 






/* maximum open i- nodes in system */ 


files 


number 


/* maximum open files in system */ 


nf locks 


number 


/* maximum locks active in system */ 


mounts 


number 


/* maximum file systems mounted */ 


regions 


number 


/* total number of regions in */ 






/* system */ 


procs 


number 


/* maximum processes in system */ 


maxproc 


number 


/* maximum processes per user ID */ 


maxfsiz 


number 


/* ulimit default in 512-byte */ 






/* blocks */ 


maxumem 


number 


/* maximum number of pages per */ 






/* process */ 
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cbufsize 


number 


/* console circular buffer size in 






/* bytes */ 


cl ists 


number 


/* number of 64- byte character */ 






/* buffers */ 


msgmax 


number 






/* maximum characters in a message */ 


msgmni 


number 






/* maximum active message queues */ 


msgmnb 


number 


/* maximum total characters in */ 






/* message queues */ 


msgtql 


number 


■/* maximum messages in system */ 


msgssz 


number 


f* msgssz * msgseq = number of */ 


msgseq 


number 


/* bytes of system buffering */ 


nlddrv 


number 


/* maximum number of loadable */ 






I* drivers */ 


senromi 


number 


/* maximum active semaphores */ 


semmns 


number 






/* maximum semaphores in system */ 


semmsf 


number 


/* maximum semaphores per ID */ 


semopm 


number 


/* maximum operations per semop */ 






/* call */ 


s emu me 


number 


/* maximum undo structures per */ 






/* process */ 


semmnu 


number 


/* maximum undo structures in */ 






/* system */ 


shmmax 


number 


/* maximum bytes in a shared */ 






/* segment */ 


shrrmtn 


number 


/* minimum bytes in a shared */ 






/* segment */ 


shirnni 


number 






/* maximum active shared segments */ 


shmseg 


number 






/* maximum attached segments per */ 






/* process */ 


sysname 


"string** 


/* default system name */ 


nodename 


"string" 


/* default node name */ 



Certain parameters if set to 0 will allow the kernel to auto- 
configure. Max users, processes, regions, i-nodes, files, 
and buffers are autoconfigurable. The number of users is 
based on the amount of physical memory; the number of 
processes is based on the number of users; regions, i- 
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nodes, and files are based on the number of processes. 
The number of buffers is based on the amount of physical 
memory. Any or all of these may be overridden. 

EXAMPLE 

To configure a system with the following devices: 

• Onboard quarter-inch' tape 

• Onboard SCSI disks 

• RS-232-C (any number of ports) 

• One parallel line printer 

• Root device is a fixed disk (drive 0, section 1) 

• Pipe device is a fixed disk (drive 0, section 1) 

• Swap device is a fixed disk (drive 0, section 2) 

• Number of buffers is 100 

• Number of processes is 100 

• Maximum number of processes per user ID is 25 

• Number of mounts is 6 

• Number of i-nodes is 100 

• Number of files is 120 

• Number of character buffers is 64 

The actual system configuration would be specified as follows: 

diskonbd 

serial 

qic 

console 
pip 

root diskonbd 01 
pipe diskonbd 01 
swap diskonbd 02 

* Conroents may be inserted in this manner 
buffers 100 



procs 


100 


maxproc 25 




mounts 


6 


i nodes 


100 


files 


120 


cl ists 


64 



FILES 

/etc/master default input master device table 
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config.h 
conf.c 



default output configuration header file 
default output configuration table file 



SEE ALSO 

master(4) in the Programmer's Reference Manual. 
DIAGNOSTICS 

Diagnostics are routed to the standard output and are self- 
explanatory. 
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NAME 

cons - control of system console 
SYNOPSIS 

cons [ -o output ] [ -i input ] [ -I ] [ -c char ] [ -I lines j 
[ -p [ +-= ] letters ] [ -f [ +-= ] be ] [ -F ] [ -s ] 

DESCRIPTION 

Cons is used to control the functions of the system console. 
The system console is used for display of kernel diagnostics 
as well as input and output of the kernel debugger (if loaded). 
Use of this command to change parameters is restricted to 
the super-user, although anyone may invoke it merely to 
report the current parameters. 

OPTIONS 

-o Followed by the name of a tty device {output), causes the 
specified tty to be used for display of kernel diagnostics. 

-i Followed by the name of a tty device (input), causes the 
specified tty to be used as the input device for the con- 
sole break character. When the console break character 
is typed on the specified tty, the kernel will break into the 
kernel debugger 

-I Specifies that any tty may be used as the input device. In 
other words, the kernel debugger will be entered when 
the console break character is typed on any tty. 

•c Followed by a character char, specifies the console break 
character. The default is control-B, The character may be 
specified as a single character, a character preceded by a 
carat (to indicate a control character), or an octal value 
preceded by a backslash. 

-I Followed by an integer, will cause kernel diagnostics to 
pause after that many lines, until a character is typed. A 
value of zero disables this feature. The default is zero, 

-p Changes the level of kernel diagnostics. There are 32 lev- 
els of diagnostics, each identified by a letter from a-z and 
A-F. Each level may be individually enabled or disabled. 
If the -p is followed by a plus sign and a list of letters, 
those levels are enabled. If the -p is followed by a minus 
sign and a list of letters, those levels are disabled. If the - 
p is followed by two minus signs, all diagnostics are 
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disabled. If the -p is followed by an equals sign and a list 
of letters, exactly those levels are enabled and all other 
levels are disabled. More than one -p option may be 
specified. 

-f Changes the handling of all kernel diagnostics. By 
default, diagnostics go to the system console as well as to 
a buffer where they can be read by the system error 
demon [see errdemon(IM)]. The two flag letters c and b 
enable the outputting of diagnostics to the console and 
the buffer respectively. Thus -f-c stops diagnostics from 
going to the console. 

-F Causes the kernel diagnostics which are currently in the 
buffer to be flushed to the error daemon. Normally, the 
diagnostics remain in the buffer until the buffer is nearly 
full, at which time they are flushed to the daemon. 

■s Normally, when cons is finished, it prints a description of 
the current settings of all console parameters. The -s flag 
suppresses this printing. 

Cons with no parameters simply prints the current parameters 
without changing anything. 
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NAME 

cpset - install object files in binary directories 
SYNOPSIS 

cpset [ -o ] object directory [ mode owner group ] 
DESCRIPTION 

Cpsef is used to install the specified object file in the given 
directory. The mode, owner, and group of the destination file 
may be specified on the command line. If this data is omitted, 
two results are possible: 

• If the user of cpset has administrative permissions (that 
is, the user's numerical ID is less than 100), the following 
defaults are provided: 

mode - 0755 

owner - bin 

group - bin 

« If the user is not an administrator, the default, owner, and 
group of the destination file will be that of the invoker. 

An optional argument of -o will force cpset to move object to 
OLOobject in the destination directory before installing the 
new object. 

For example: 

cpset echo /bin 0755 bin bin 

cpset echo /bin 

cpset echo /bin/echo 

All the examples above have the same effect (assuming the 
user is an administrator). The file echo will be copied into /bin 
and will be given 0755, bin, and bin as the mode, owner, and 
group, respectively, 

Cpset utilizes the file /usr/src/destinations to determine the 
final destination of a file. The locations file contains pairs of 
pathnames separated by spaces or tabs. The first name is 
the "official" destination (for example: /bin/echo). The 
second name is the new destination. For example, if echo is 
moved from /bin to /usr/bin, the entry in 
/usr/src/destinations would be: 
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/bin/echo /usr/bin/echo 

When the actual installation happens, cpset verifies that the 
"old" pathname does not exist. If a file exists at that location, 
cpset issues a warning and continues. This file does not exist 
on a distribution tape; it is used by sites to track local com- 
mand movement. The procedures used to build the source 
are responsible for defining the "official" locations of the 
source. 

Cross Generation 

The environment variable ROOT will be used to locate the des- 
tination file (in the form $ROOT/usr/src/destinations). This is 
necessary in the cases where cross generation is being done 
on a production system. 

SEE ALSO 

install(IM). 

make(1) in the Programmer's Reference Manual. 
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NAME 

cram - read/write CMOS RAM 

SYNOPSIS 

cram -r addr 

cram -w addr value 

DESCRIPTION 

Cram reads or writes a single byte to or from the CMOS RAM. 
The 6000/50 has 64 bytes of CMOS RAM, most of which are 
used at boot time by the boot ROM. The first form of the 
command reads the byte at the given address addr, which 
should be a decimal number between 0 and 63, and prints the 
byte read as a decimal integer on the standard output. The 
second form of the command writes the byte at the given 
address addr with the given value, which should be a decimal 
number between 0 and 255. You must have superuser 
privileges to run the second form of the command. 

FILES 

/dev/cram 

SEE ALSO 

cramsetup(IM). 

U 6000 Series Technical Reference Manual. 
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NAME 

cramsetup - set up default values in CMOS RAM 

SYNOPSIS 

cramsetup fltype f2type 

DESCRIPTION 

Cramsetup sets up default parameters in the CMOS RAM. 
this allows 6000/50 to boot without having to run the Setup 
function of the 6000/50 Diagnostics. Fltype and f2type are 
integers specifying the type for the first and second floppy 
disk drives on the system. The supported types are as fol- 
lows: 

0 - no drive present 

1 - 360KB 5.25 inch drive 

2 - 1.2MB 5.25 inch drive 

3 - 720KB 3.5 inch drive 

4 - 1.44MB 3.5 inch drive 

Both parameters must be present. In addition to making the 
floppy disk types available to System V, several other parame- 
ters are initialized, and the hard disk parameters for MS-DOS 
diskettes are set to 0, indicating that no MS-DOS hard disks 
are available. Base memory is set at 640KB. Extended 
memory is computed and initialized. The installed equipment 
byte is set up with the number of floppy drives configured and 
with no display adapter present. The diagnostic status is 
cleared. Finally, the checksum for the CMOS RAM is updated. 

These initialization steps are taken to bring the CMOS RAM to 
a state that is recognized as acceptable to the ROM based 
boot routines. As a result, the 6000/50 subsequently boots 
without a configuration error and a message to run Setup 
from the Diagnostics diskette. 

EXAMPLE 

To initialize the CMOS RAM and configure the system for one 
1.2MB 5.25 inch floppy drive: 

/etc/cramsetup 2 0 

WARNING 

This utility is intended for a system in which only System V will 
be booted. If the system is to be configured so that MS-DOS 
is booted, then the Setup utility from the Diagnostics should 
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be run instead of cramsetup. 

SEE ALSO 

cram(1M). 
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NAME 

crash - examine system images 
SYNOPSIS 

/etc/crash [ -d dumpfile ] [ -n namelist j [ -w outputfile ] 
DESCRIPTION 

The crash command is used to examine the system memory 
image of a live or a crashed system by formatting and printing 
control structures, tables, and other information. Command 
line arguments to crash are dumpfile, namelist, and outputfile. 

Dumpfile is the file containing the system memory image, and 
can be /dev/mem, a regular file, or partition 0 of the root disk, 
which always contains the system image of the last panic. 
The default dumpfile is /dev/mem. 

The text file namelist contains the symbol table information 
needed for symbolic access to the system memory image to 
be examined. The default namelist is funix. If a system image 
from another machine is to be examined, the corresponding 
text file must be copied from that machine. 

When the crash command is invoked, a session is initiated. 
The output from a crash session is directed to outputfile. The 
default outputfile is the standard output. 

Input during a crash session is of the form: 

function [ argument . . . ] 

where function is one of the crash functions described under 
"FUNCTIONS" below, and arguments are qualifying data that 
indicate which items of the system image are to be printed. 

The default for process- related items is the current process for 
a running system and the process that was running at the 
time of the crash for a crashed system. If the contents of a 
table are being dumped, the default is all active table entries. 

The following function options are available to crash functions 
wherever they are semantically valid. 
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■e Display every entry in a table, 

-f Display the full structure. 

-p Interpret all address arguments in the command 

line as physical addresses, 

-s process Specify a process slot other than the default. 

-w file Redirect the output of a function to file. 

Note that if the -p option is used, all address and symbol 
arguments explicitly entered on the command line will be inter- 
preted as physical addresses. If they are not physical 
addresses, results will be inconsistent. 

The functions mode, defproc, and redirect correspond to the 
function options -p, -s, and -w. The mode function may be 
used to set the address translation mode to physical or virtual 
for all subsequently entered functions; defproc sets the value 
of the process slot argument for subsequent functions; and 
redirect redirects all subsequent output. 

Output from crash functions may be piped to another pro- 
gram in the following way: 

function [ argument . . . ] ! shell_command 

For example, 

mount ! grep rw 

will write all mount table entries with an rw flag to the stan- 
dard output. The redirection option (-w) cannot be used with 
this feature. 

Depending on the context of the function, numeric arguments 
will be assumed to be in a specific radix. Counts are assumed 
to be decimal. Addresses are always hexadecimal. Table 
address arguments larger than the size of the function table 
will be interpreted as hexadecimal addresses; those smaller 
will be assumed to be decimal slots in the table. Default bases 
on all arguments may be overridden. The C conventions for 
designating the bases of numbers are recognized; A number 
that is usually interpreted as decimal will be interpreted as 
hexadecimal if it is preceded by Ox and as octal if it is pre- 
ceded by 0. Decimal override is designated by Od, and binary 
by Ob. 
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Aliases for functions may be any uniquely identifiable initial 
substring of the function name. Traditional aliases of one 
letter, such as p for proc % remain valid. 

Many functions accept different forms of entry for the same 
argument. Requests for table information will accept a table 
entry number, a physical address, a virtual address, a symbol, 
a range, or an expression. A range of slot numbers may be 
specified in the form a-b where a and 6 are decimal numbers. 
An expression consists of two operands and an operator. An 
operand may be an address, a symbol, or a number; the 
operator may be +, *, /, &, or ;. An operand which is a 
number should be preceded by a radix prefix if it is not a 
decimal number (0 for octal, Ox for hexidecimal, Ob for binary). 
The expression must be enclosed in parentheses (). Other 
functions will accept any of these argument forms that are 
meaningful. 

Two abbreviated arguments to crash functions are used 
throughout. Both accept data entered in several forms. They 
may be expanded into the following: 

table_entry = table entry } address J symbol j range 
\ expression 

start_addr - address | symbol { expression 

FUNCTIONS 

? [ -w file ] 

List available functions. 

Icmd 

Escape to the shell to execute a command. 

adv [ -e ] [ -w file ] [ [ -p ] table_entry .'..■] 
Print the advertise table. 
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base [ -w file ] number . . . 

Print number in binary, octal, decimal, and hexadecimal. A 
number in a radix other then decimal should be preceded 
by a prefix that indicates its radix as follows: Ox, hexide- 
cimal; 0, octal; and Ob, binary. 

buffer [ -w file ] [ -format ] bufferslot 

or 

buffer [ -w file ] [ -format ] [ -p ] start_addr 
Alias: b. 

Print the contents of a buffer in the designated format. 
The following format designations are recognized: -b, 
byte: -c, character; «d, decimal; -x, hexadecimal; -o, octal; 
-r, directory; and -I, i-node. If no format is given, the pre- 
vious format is used. The default format at the beginning 
of a crash session is hexadecimal. 

bufhdr t -f ] [ -w file ] [ [ -p ] table_entry . . . j 
Alias: buf. 

Print system buffer headers. 

callout [ -w file ] 
Alias: c. 

Print the callout table. 

dbailoc [ *w file ] [ class . . . ] 

Print the dbailoc table. If a class is entered, only data 
block allocation information for that class will be printed. 

dbfree [ -w file ] [ class , . . J 

Print free streams data block headers. If a class is 
entered, only data block headers for the class specified 
will be printed. 
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dblock [ -e ] [ -w file ] f -c class . . . ] 
or 

dblock [ -e ] [ -w file ] [ [ -p ] table^entry . . . ] 

Print allocated streams data block headers. If the class 
option (-c) is used, only data block headers for the class 
specified will be printed. 

defproc [ -w file ] [ -c ] 

or 

defproc [ -w file ] [ slot ] 

Set the value of the process slot argument. The process 
slot argument may be set to the current slot number (-c) 
or the slot number may be specified. If no argument is 
entered, the value of the previously set slot number is 
printed. At the start of a crash session, the process slot 
is set to the current process. 

dis [ -w file ] [ -a ] start_addr [ count ] 

Disassemble from the start address for count instructions. 
The default count is 1. The absolute option (-a) specifies 
a non-symbolic disassembly. 

ds [ -w file ] virtualaddress . . . 

Print the data symbol whose address is closest to, but not 
greater than, the address entered. 

file [ -e ] [ -w file ] [ [ -p ] table entry . . . ] 
Alias: f. 

Print the file table. 

findaddr [ -w file ] table slot 

Print the address of slot in table. Only tables available to 
the size function are available to findaddr. 

f indslot I -w file ] virtual address . . . 

Print the table, entry slot number, and offset for the 
address entered. Only tables available to the size func- 
tion are available to f indslot. 

fs [ -w file ] [ [ -p J table_entry . . . ] 

Print the file system information table. 

gdp [ -e ] [ -f J [ -w file ] [ [ -p ] table_entry . . . ] 
Print the gift descriptor protocol table. 



UP-13529 



Page 5 



CRASH(IM) 



gdt [ -e ] [ -w file ] [ [ -p ] tabie_entry . . . ] 
Print the global descriptor table. 

help [ -w file ] function . . . 

Print a description of the named function, including syn- 
tax and aliases. 

idt [ -e J [ -w file ] [ [ -p ] table_entry . . . ] 
Print the global descriptor table. 

inode [ -e ] [ -f ] [ -w file j [ [ -p ] table_entry . . . ] 
Alias: i. 

Print the i-node table, including file system switch infor- 
mation. 

kfp [ -w file ] [ value ] 

Print the frame pointer for the start of a kernel stack 
trace. If the value argument is supplied, the kfp is set to 
that value. 

Ick [ -e ] [ -w file ] [ [ -p J table_entry ... J 
Alias: I. 

Print record locking information. If the -e option is used or 
table address arguments are given, the record lock list is 
printed. If no argument is entered, information on locks 
relative to i-nodes is printed. 

Idt [ -e ] [ -w file f [ -s process J [ [ -p ] table_entry . . . ] 

Print the local descriptor table for the given process, or 
for the current process if none is given. 

linkblk [ -e ] [ -w file ] [ [ -p ] tablejmtry . . . ] 
Print the linkblk table. 

map [ -w file ] mapname . . , 

Print the map structure of the given mapname. 

mbfree [ -w file ] 

Print free streams message block headers. 

mblock [ -e ] [ -w filename ] [ [ -p J table_entry . . . ] 
Print allocated streams message block headers. 

mode [ -w file ] [ mode ] 

Set address translation of arguments to virtual (v) or phy- 
sical (p) mode. If no mode argument is given, the current 
mode is printed. At the start of a crash session, the 
mode is virtual. 
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mount [ -e ] [ -w file ] [ [ -p ] table_entry . . . ] 
Alias: m. 

Print the mount tabie, 

nm [ -w file ] symbol . . . 

Print value and type for the given symbol. 

od [ -p ] [ -w file j [ -format ] [ -mode ] [ -s process ] 
start_addr [ count } 
Alias: rd. 

Print counf values starting at the start address in one of 
the following formats: character (-c), decimal (-d), hexa- 
decimal (-x), octal (-o), ASCII (-a), or 
hexadecimal/character (-h), and one of the following 
modes: long (-1), short (-t), or byte (-b). The default 
mode for character and ASCII formats is byte; the default 
mode for decimal, hexadecimal, and octal formats is long. 
The format -h prints both hexadecimal and character 
representations of the addresses dumped; no mode 
needs to be specified. When format or mode is omitted, 
the previous value is used. At the start of a crash ses- 
sion, the format is hexadecimal and the mode is long. If 
no count is entered, 1 is assumed. 

pcb [ -w file ] [ process ] 

Print the process control block (TSS) for the given pro- 
cess. If no arguments are given, the active TSS for the 
current process is printed. 

pdt [ -e ] [ -w file ] [ -s process ] section segment 

or 

pdt [ -e ] [ -w file ] [ -s process ] [ -p ] start_addr [ count ] 
The page descriptor table of the designated memory sec- 
tion and segment is printed. Alternatively, the page 
descriptor table starting at the start address for count 
entries is printed. If no count is entered, 1 is assumed. 

pfdat [ -e ] [ - w file ] [ [ -p ] table_entry . . . ] 
Print the pfdata table. 

proc [ -f ] [ -w file ] [ [ -p ] table_entry . . . #procid . . . ] 

or 

proc [ -f ] [ -w file ] [ -r ] 
Alias: p. 
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Print the process table. Process table information may be 
specified in two ways. First, any mixture of table entries 
and process IDs may be entered. Each process ID must 
be preceded by a #. Alternatively, process table informa- 
tion for runnable processes may be specified with the 
runnable option (-r). 

qrun [ -w file ] 

Print the list of scheduled streams queues. 

queue [ -e ] [ -w file ] [ [ -p ] table_entry . . . ] 
Print streams queues. 

quit 

Alias: q. 

Terminate the crash session. 

rcvd [ -e ] [ -f ] [ -w file ] [ [ -p J table_entry . . . ] 
Print the receive descriptor table. 

redirect [ -w file ] [ -c ] 

or 

redirect [ -w file ] [ file ] 

Used with a file name, redirects output of a crash session 
to the named file. If no argument is given, the file name 
to which output is being redirected is printed. Alterna- 
tively, the close option (-c) closes the previously set file 
and redirects output to the standard output. 

region [ -e ] [ -w file ] [ [ -p ] tableentry . . . ] 
Print the region table. 

sdt [ -e ] [ -w file ] [ -s process ] section 

or 

sdt [ -e ] [ -w file ] [ -s process ] [ -p ] start_addr [ count ] 
The segment descriptor table for the named memory sec- 
tion is printed. Alternatively, the segment descriptor table 
starting at start address for count entries is printed. If no 
count is given, a count of 1 is assumed. 

search [ -p ] [ -w file ] [ -m mask ] [ -s process 3 pattern 

start_addr length 

Print the words in memory that match pattern, beginning 
at the start address for length words. The mask is anded 
(&) with each memory word and the result compared 
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against the pattern. The mask defaults to Oxffffffff. 

size [ -w file ] [ -x ] [ structurename . . . ] 

Print the size of the designated structure. The (-x) option 
prints the size in hexadecimal. If no argument is given, a 
list of the structure names for which sizes are available is 
printed. 

sndd [ -e ] [ -w file ] [ [ -p J table_entry . . . ] 
Print the send descriptor table. 

srmount [ -e ] [ -w file ] [ [ -p ] table_entry . . . ] 
Print the server mount table. 

stack [ -w file J [ process ] 
Alias: s. 

Dump stack. If no arguments are entered, the kernel 
stack for the current process is printed. Otherwise, the 
kernel stack for the given process is printed. 

stat [ -w file ] 

Print system statistics. 

stream [ -e ] [ -f ] [ -w file ] [ [ -p ] tabfe^entry . . . ] 
Print the streams table. 

strstat t -w file ] 

Print streams statistics. 

trace [ -w file ] [ -r ] [ process ] 
Alias: t. 

Print kernel stack trace. The kfp value is used with the -r 
option. 

ts [ -w file ] virtual_address . . . 

Print closest text symbol to the designated address. 

tty { -e ] [ -f ] [ -w file ] [ -t type [ [ -p ] table_entry . . . ] ] 

or 

tty [ -e ] [ -f ] [ -w file ] [ [ -p ] start_addr ] 
Valid types: pp, iu. 

Print the tty table. If no arguments are given, the tty table 
for both tty types is printed. If the -t option is used, the 
table for the single tty type specified is printed, If no 
argument follows the type option, all entries in the table 
are printed. A single tty entry may be specified from the 
start address. 
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user [ -f ] [ -w file j [ process ] 
Alias: u. 

Print the ublock for the designated process. 

var [ -w file ] 
Alias: v. 

Print the tunable system parameters. 

vtop [ -w file ] [ -s process ] start_addr . . . 

Print the physical address translation of the virtual start 
address. 

FILES 

/dev/mem system image of currently running system 

SEE ALSO 

diskutil(IM). 
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NAME 

cron - clock daemon 

SYNOPSIS 
/etc/cron 

DESCRIPTION 

Cron executes commands at specified dates and times. Regu- 
larly scheduled commands can be specified according to 
instructions found in crontab files in the directory 
/usr/spool/cron/crontabs. Users can submit their own cron- 
tab file via the crontab(\) command. Commands which are to 
be executed only once may be submitted via the ar(1) com- 
mand. 

Cron only examines cronfab files and at command files during 
process initialization and when a file changes via crontab or at. 
This reduces the overhead of checking for new or changed 
files at regularly scheduled intervals. 

Since cron never exits, it should be executed only once. This 
is done routinely through /etc/rc2.d/S75cron at system boot 
time. The file /usr/Iib/cron/FIFO is used as a lock file to 
prevent the execution of more than one cron. 

FILES 

/usr/lib/cron 
/usr/lib/cron/FIFO 
/usr/lib/cron/log 
/usr/spool/cron 

SEE ALSO 

at(1), crontab(1), sh(1) in the User's Reference Manual, 

DIAGNOSTICS 

A history of all actions taken by cron are recorded in 
/usr/lib/cron/log. 



main cron directory 
used as a lock fife 
accounting information 
spool area 
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NAME 

ctinstall, getgrps - install software 
SYNOPSIS 

/install/ctinstail [ update j silent | install ] [ groups ... ] 
DESCRIPTION 

Ctinstall is used to install operating system software and appli- 
cation software from quarter-inch tape and diskette media. It 
must be invoked in single-user mode. 

Before executing ctinstall, the user should cd to the directory 
under which files will be installed. (Normally this is /.) The 
user must ensure that all necessary mounted file systems are 
mounted. 

If no arguments are provided to ctinstall, the user will be 
prompted for the required information. The option install is 
for raw, or first installs; update is for software updates; silent 
is the same as update but with fewer questions asked (silent is 
recommended); groups is any number of group names speci- 
fied in the software product's associated proto file. 

EXAMPLE 

A sample installation session is illustrated here. User 
responses are shown in bold type. A carriage return is 
implied after all user input. 

cd / 

shutdown -is 

Shutdown started. XXX XXX XX XX:XX:XX XST 19XX 

Broadcast Message from root (console) on 
Convgt XXX XXX XX XX:XX:XX XST 19XX 
THE SYSTEM IS BEING SHUT DOWN NOW 1 1 1 
Log off now or risk your files being damaged. 

Do you really want to shutdown the system? (y or n): y 

Cleaning up, please wait 

System Services are now being stopped 

No demon active 

Error logging stopped 

Line printer scheduler stopped 

LP spooler stopped 

cron aborted: SIGTERM 
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INIT: New run level : S 
INIT: SINGLE USER MODE 

Positioning the tape for Product Installation 

Update, silent update or new installation of ISAM 5.00 
('update', 'silent' or 'install')?: install 

Please enter your group choices for ISAM separated by blanks. 
Your choices are: 

ISAM 

If you'd like all of the groups, type 'all': 

if you'd like none of the groups, type 'none': ISAM 

This procedure will install the following ISAM 5.00 group(s) 
on your system into /: 

ISAM 

Starting to Install Qroup(s) ISAM into /. 
Installing Group ISAM. 

Calculating size required for group ISAM. 

Installing required ISAM files, 
install/! samRel 
usr/include/isam.h 
usr/ i nc 1 ude / i ser c . h 
usr/ 1 i b/ i sam/ 1 samConf i g 
usr/1 ib/isam/IsamCreate 
usr/1 ib/ i sam/ I saraPr otect 
usr/1 i b/ i sam/ 1 samReorg 
usr/1 ib/isam/IsamStat 
usr/1 ib/isam/isamStop 
usr/1 ib/isam/IsamTransfer 
usr/1 ib/isam/lxFiltcr 
usr/1 ib/isam/lxSpec 
usr/1 ib/isam/isam 

Checking permissions, modes and omissions on new ISAM 
commands . 

Completed Installation of Group ISAM. 
Rewinding tape. 

Installation Complete. 
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SEE ALSO 

Release Notice for software product being installed. 
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NAME 

dcopy - copy file systems for optimal access time 
SYNOPSIS 

/etc/dcopy [ -sX ] [ -an J [ -d ] [ «v ] [ -ffsize [ : isize ] 
] 

inputfs outputfs 
DESCRIPTION 

Dcopy copies file system inputfs to outputfs, Inputfs is the 
device file for the existing file system; outputfs is the appropri- 
ately sized device file to hold the reorganized result. For the 
most effective optimization inputfs should be the raw device 
and outputfs should be the block device. Both inputfs and 
outputfs should be unmounted file systems (in the case of the 
root file system, the copy must be to a new pack). 

With no options, dcopy copies files from inputfs compressing 
directories by removing vacant entries, and spacing consecu- 
tive blocks in a file by the optimal rotational gap. The possible 
options are 

-sX supply device information for creating an optimal 

organization of blocks in a file. The forms of X 
are the same as the -s option of fsck[1M). 

•an place the files not accessed in n days after the 

free blocks of the destination file system (default 
for n is 7). If no n is specified then no movement 
occurs^ 

-d leave order of directory entries as is (default is to 

move sub- directories to the beginning of direc- 
tories). 

-v currently reports how many files were processed, 

and how big the source and destination freelists 
are. 

-ffsize [zisize] 

specify the outputfs file system and i-node list 
sizes (in blocks). If the option (or :isize) is not 
given, the values from the inputfs are used. 

Dcopy catches interrupts and quits, and reports on its pro- 
gress. To terminate dcopy send a quit signal, followed by an 
interrupt or quit. 
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SEE ALSO 

fsck(1M), mkfs(1M). 

ps(1) in the User's Reference Manual. 
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NAME 

dd - convert and copy a file 

SYNOPSIS 

dd [ option = value ] ... 

DESCRIPTION 

Dd copies the specified input file to the specified output with 
possible conversions. The standard input and output are used 
by default. The input and output block size may be specified 
to take advantage of raw physical I/O. 

option values 

if = file input file name; standard input is default 

of =r7/e output file name; standard output is default 

ibs=ft input block size n bytes (default 512) 

obs = n output block size (default 51 2) 

bs = /i set both input and output block size, 

superseding ibs and obs; also, if no conver- 
sion is specified, it is particularly efficient since 
no in-core copy need be done 

cbs = n conversion buffer size 

skip = ft skip n input blocks before starting copy 

seek = n seek n blocks from beginning of output file 
before copying 

count =n copy only ft input blocks 

conv = ascii convert EBCDIC to ASCII 
ebcdic convert ASCII to EBCDIC 
ibm slightly different map of ASCII to EBCDIC 
lease map alphabetics to lower case 
ucase map alphabetics to upper case 
swab swap every pair of bytes 
noerror do not stop processing on an error 
sync pad every input block to /6s 
....... several comma-separated conversions 
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Where sizes are specified, a number of bytes is expected. A 
number may end with k, b, or w to specify multiplication by 
1024, 512, or 2, respectively; a pair of numbers may be 
separated by x to indicate multiplication. 

Cbs is used only if conv=ascii or conv = ebcdic is specified. 
In the former case, cos characters are placed into the conver- 
sion buffer (converted to ASCII). Trailing blanks are trimmed 
and a new-line added before sending the line to the output. 
In the latter case, ASCII characters are read into the conver- 
sion buffer (converted to EBCDIC). Blanks are added to make 
up an output block of size cbs. 

After completion, dd reports the number of whole and partial 
input and output blocks. 

DIAGNOSTICS 

f+p blocks in(out) 

numbers of full and partial blocks read(written) 
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NAME 

devnm - device name 

SYNOPSIS 

/etc/devnm [ names ] 

DESCRIPTION 

Devnm identifies the special file associated with the mounted 
file system where the argument name resides. 

This command is most commonly used by /etc/brc [see 
ore (1M)] to construct a mount table entry for the root device. 

EXAMPLE 

The command: 

/etc/devnm /usr 
produces: 

/dev/dsk/c0d0s3 usr 
if /usr is mounted on /dev/dsk/c0d0s3. 

FILES 

/dev/dsk/* 
/etc/mnttab 

SEE ALSO 

brc{1M). 
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NAME 

df - report number of free disk blocks and i-nodes 

SYNOPSIS 

df [ -It ] [ -f ] [ file-system | directory \ 
mounted- resource ] 

DESCRIPTION 

The df command prints out the number of free blocks and 
free i-nodes in mounted file systems, directories, or mounted 
resources by examining the counts kept in the super- blocks. 

File-system may be specified either by device name (for exam- 
ple, /dev/dsk/c0d0s1) or by mount point directory name (for 
example, /usr). 

Directory can be a directory name. The report presents infor- 
mation for the device that contains the directory. 

Mounted-resource can be a remote resource name. The report 
presents information for the remote device that contains the 
resource. 

If no arguments are used, the free space on all locally and 
remotely mounted file systems is printed. 

The df command uses the following options: 

-1 only reports on local file systems. 

-t causes the figures for total allocated blocks and i-nodes 
to be reported as well as the free blocks and i-nodes. 

-f an actual count of the blocks in the free list is made, 
rather than taking the figure from the super-block (free i- 
nodes are not reported). This option will not print any 
information about mounted remote resources. 

NOTE 

If multiple remote resources are listed that reside on the same 
file system on a remote machine, each listing after the first 
one will be marked with an asterisk. 

FILES 

/dev/dsk/* 
/etc/mnttab 

SEE ALSO 

mount(1M). 
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fs(4), mnttab(4) in the Programmer's Reference Manual, 
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NAME 

diskusg - generate disk accounting data by user ID 

SYNOPSIS 

/usr/lib/acct/diskusg [ options ] [ files ] 

DESCRIPTION 

Diskusg generates intermediate disk accounting information 
from data in files, or the standard input if omitted. Diskusg 
outputs lines on the standard output, one per user, in the fol- 
lowing format: 

uid login #block$ 

where 

uid is the numerical user ID of the user; 

login is the login name of the user; and 

#blocks is the total number of 512-byte disk blocks allo- 
cated to this user. 

Diskusg normally reads only the i-nodes of file systems for 
disk accounting. In this case, files are the special filenames of 
these devices. 

Diskusg recognizes the following options: 

-s The input data is already in diskusg output for- 

mat. Diskusg combines all lines for a single user 
into a single line. 

-v Verbose, Print a list on standard error of all files 

that are charged to no one. 

•i fnmlist Ignore the data on those file systems whose file 
system name is in fnmlist. Fnmlist is a list of file 
system names separated by commas or enclose 
within quotes. Diskusg compares each name in 
this list with the file system name stored in the 
volume ID [see labelit(lM)]. 

•p file Use file as the name of the password file to gen- 
erate login names, /etc/passwd is used by 
default. 

-u file Write records to file of files that are charged to 
no one. Records consist of the special file name, 
the i-node number, and the user ID. 
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The output of diskusg is normally the input to acctdisk [see 
accf(lM)] which generates total accounting records that can 
be merged with other accounting records. Diskusg is nor- 
mally run in dodisk [see acctsh (1M)]. 

EXAMPLES 

The following will generate daily disk accounting information: 

for i in s1 s3; do 

diskusg /dev/rdsk/cOdO$i > dtmp . ' basename $i' & 

done 
wait 

diskusg -s dtmp.* ! sort +0n +1 ' acctdisk > disktacct 
FILES 

/etc/passwd used for user ID to login name conver- 

sions 

SEE ALSO 

acct(1M), acctsh (1M). 

acct(4) in the Programmer's Reference Manual. 
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NAME 

diskutil - display disk information, copy in crash dump files 

SYNOPSIS 

diskutil -cdlbpvBsk devicefile 

diskutil -D devicefile crashdumpfile 

DESCRIPTION 

The first form of the diskutil command displays configuration 
information for the disk drive specified by devicefile. 

The second form of the command copies a crash dump file 
from the specified devicefile into crashdumpfile, where it can 
be accessed and analyzed using crash (1M). 

Diskutil understands the following options. Devicefile must 
specify a device that has a valid volume home block (VHB): 

-c Print the disk parameters for devicefile. 

-d Print the starting location and size of the dump area for 
the specified disk device. 

-I Print the starting location and size of the loader area for 
the specified disk device. 

-b Print the starting location and size of the boot area for the 
specified disk device. 

•p Print the partition table for the specified disk device. 

-v Verbose mode: used with -dlb, prints out additional 
descriptive detail along with the statistics. 

-B Display information requested by the -dlb options as 
number of bytes. 

-s Display information requested by the -dlb options as 
number of sectors. 

-k Display information requested by the -dlb options as 
number of 1K blocks. 

EXAMPLES 

To display loader area information for device 
/dev/rdsk/cOdOsO: 

S diskutil -1 /dev/rdsk/cOdOsO 

1 128 

$ 
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To print the same information in verbose mode using byte 
units: 

$ diskutil -lvB /dev/rdsk/cOdOsO 

Loader area : start at byte offset 1024, 
size ( 131072 bytes ). 

$ 

To display the disk parameters for the same device: 

$ diskutil -c /dev/rdsk/cOdOsO 

Volume: 0280 
876 cyl inders, 
6 heads, 

32 physical sectors (of 512 bytes) per track, 
182 physical sectors per cylinder, 
168182 physical sectors per disk 

$ 
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NAME 

dname - print Remote File Sharing domain and network 
names 

SYNOPSIS 

dname [ -D domain ] [ -N netspec J [ -dna ] 
DESCRIPTION 

Dname prints or defines a host's Remote File Sharing domain 
name or the network used by Remote File Sharing as tran- 
sport provider. When used with d, n, or a options, dname can 
be run by any user to print the domain name, network name 
or both, respectively. Only a user with root permission can 
use the -D domain option to set the domain name for the host 
or -N netspec to set the network specification used for 
Remote File Sharing. (The value of netspec is the network 
device name, relative to the /dev directory. For example, the 
TCP network uses tcp.) 

Domain must consist of no more than 14 characters, consist- 
ing of any combination of letters (upper and lower case), 
digits, hyphens (-), and underscores (J. 

When dname is used to change a domain name, the host's 
password is removed. The administrator will be prompted for 
a new password the next time Remote File Sharing is started 
[rfstart{1M)). 

II dname is used with no options, it will default to dname -d. 
ERRORS 

You cannot use the -N or -D options while Remote File Shar- 
ing is running. 

SEE ALSO 

rfstart(lM). 
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NAME 

drvload - load drivers 

SYNOPSIS 

drvload [ -n ] [ -d ] [ driver ] 

DESCRIPTION 

This program is executed at boot time to load all loadable 
drivers. If drvload is executed with no arguments, it loads all 
drivers listed in the file /etc/lddrv/drvtab. If a driver argument 
is given, that driver is loaded and is also installed in 
/etc/lddrv/drvtab, so that it will be automatically loaded every 
time the system is booted. 

Drvload has two options: 

-n Causes the driver to be installed in /etc/lddrv/drvtab 
without being loading. [To load a driver without installing 
it in /etc/lddrv/drvtab, see Iddrv (1M)]. 

-d This flag with no arguments causes all drivers listed in 
/etc/lddrv/drvtab to be unloaded. Supplying a driver 
argument causes that driver only to be unloaded and 
removed from /etc/lddrv/drvtab. 

The -d flag with the -n flag and a driver argument causes the 
driver to be removed from /etc/lddrv/drvtab without unload- 
ing it. In all cases, if the driver load or unload fails, 
/etc/lddrv/drvtab is not updated. 

FILES 

/etc/lddrv/drvtab 

SEE ALSO 

lddrv(1M). 
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NAME 

du - summarize disk usage 

SYNOPSIS 

du [ -sar ] [ names ] 

DESCRIPTION 

Du reports the number of 512-byte blocks contained in all files 
and (recursively) directories within each directory and file 
specified by the names argument. The block count includes 
the indirect blocks of the file. If names is missing, the current 
directory is used. 

The optional arguments are as follows: 

-s causes only the grand total (for each of the specified 
names) to be given. 

-a causes an output line to be generated for each file. 

If neither -s or -a is specified, an output line is generated for 
each directory only 

-r will cause du to generate messages about directories that 
cannot be read, files that cannot be opened, and so forth, 
rather than being silent (the default). 

A file with two or more links Is only counted once. 

BUGS 

If the -a option is not used, non-directories given as argu- 
ments are not listed. 

If there are links between files in different directories where 
the directories are on separate branches of the file system 
hierarchy, du will count the excess files more than once. 
Files with holes in them will get an incorrect block count. 
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NAME 

errdead - extract error records and status information from 
dump 

SYNOPSIS 

/etc/errdead [ -a [ e ] ] [ -v ] [ -d offset] [ dumpfile ] [ 
namelist j 

DESCRIPTION 

When hardware errors are detected by the system, an error 
record that contains information pertinent to the error is gen- 
erated. If the error-logging daemon errdemon (1 M) is not 
active, or if the system crashes before the record can be 
placed in the error file, the error information is held by the 
system in a local buffer. By default, errdead examines a sys- 
tem dump (or memory), extracts such error records, and 
passes them to errpt (1M) for analysis. 

Errdead understands the following options: 

-a Instead of passing extracted records to errpt (1M), append 
them to /usr/adm/errfile, provided that the dump 
corresponds to the namelist. 

-e Only valid if -a is also specified. Invoke errdemon (1M) 
when done. This is normally done in the rc script. 

■v Indicates that the dump file is a "virtual" dump: a virtual 
address can be used directly without translation into a 
physical address. The -v option should be used only with 
/dev/kmem, not with ordinary dump files. 

-d offset Indicates that the dump file has a header of size 
offset bytes. The actual memory image starts at byte 
offset in the 'lump file. 

The dumpfile specifies the file (or memory) that is to be exam- 
ined; if not given, errdead looks for a dump area by scanning 
the available disks in the same order as does the bootstrap 
ROM. The system namelist is specified by namelist; if not 
given, /unix is used. 

FILES 

/unix system namelist 

/usr/bin/errpt analysis program 

/usr/tmp/errXXXXXX temporary file 

/usr/adm/errfile repository for error records 
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/etc/log/confile console file 
DIAGNOSTICS 

Diagnostics may come from either errdead or errpt . In either 
case, they are intended to be self-explanatory. 

SEE ALSO 

errdemon(lM), errpt(1M). 
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NAME 

errdemon - error-logging daemon 

SYNOPSIS 

/usr/lib/errdemon [ -n 1 [ -c file ] [ file ] 

DESCRIPTION 

The error logging daemon errdemon collects error records 
from the operating system by reading the special file 
/dev/error and places them in file. If file is not specified 
when the daemon is activated, /usr/adm/errfile is used. Note 
that file is created if it does not exist; otherwise, error records 
are appended to it, so that no previous error data is lost. No 
analysis of the error records is done by errdemon; that 
responsibility is ieft to errpt (1M). Errdemon can also extract 
console records; the -n option disables this, thus forcing all 
console reports to stay in a circular buffer in the kernel. The 
-c option allows specifying a console file. The default console 
file is /etc/tog /confile. The error-logging demon is terminated 
by sending it a software kill signal [see Only the 

super-user may start the daemon, and only one daemon may 
be active at any time, 

FILES 

/dev/error 
/usr/adm/errfile 
/etc/log/confile 
/dev/console 

DIAGNOSTICS 

The diagnostics produced by errdemon are intended to be 
self-explanatory. 

SEE ALSO 

errpt(1M), errstop(lM), err(7). 

kill(1) in the User's Reference Manual. 



source of error records 
repository for error records 
console records 
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NAME 

errpt - process a report of logged errors 

SYNOPSIS 

errpt [ options ] [ files ] 

DESCRIPTION 

Errpt processes data collected by the error logging mechan- 
ism [errdemon{1M)] and generates a report of that data. The 
default report is a summary of all errors posted in the files 
named. Options apply to all files and are described below. If 
no files are specified, errpt attempts to use /usr/adm/errfile 
as file. 

A summary report notes the options that may limit its com- 
pleteness, records the time stamped on the earliest and latest 
errors encountered, and gives the total number of errors of 
one or more types. Each device summary contains the total 
number of unrecovered errors, recovered errors, errors 
unabled to be logged, I/O operations on the device, and mis- 
cellaneous activities that occurred on the device. The number 
of times that errpt has difficulty reading input data is included 
as read errors. 

Any detailed report contains, in addition to specific error infor- 
mation, alt instances of the error logging process being 
started and stopped, and any time changes [via ctefe(1)] that 
took place during the interval being processed. A summary of 
each error type included in the report is appended to a 
detailed report. 

A report may be limited to certain records in the following 
ways: 

•s date Ignore all records posted earlier than date, where 
date has the form mmddhhmmyy , consistent in 
meaning with the date (1) command. 

-e date Ignore all records posted later than date, whose 
form is as described above. 

-a Produce a detailed report that includes all error 

types. 

-d devlist A detailed report is limited to data about devices 
given in devlist, where devlist can be one of two 
forms: a list of device identifiers separated from 
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one another by a comma, or a list of device iden- 
tifiers enclosed in double quotes and separated 
from one another by a comma and/or more 
spaces. Valid devices are the character and 
block devices that appear in /etc/master. 

-p n Limit the size of a detailed report to n pages. 

-f In a detailed report, limit the reporting of block 

device errors to unrecovered errors. 

Logical blocks in the filesystem are 1024 bytes. Physical sec- 
tor numbers are 512-byte blocks. 

FILES 

/usr/adm/errfile default error file 

SEE ALSO 

errdead(IM), errdemon(IM). 

date{1) in the User's Reference Manual. 

errfile(4) in the Programmer's Reference Manual. 
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NAME 

errstop - terminate the error-logging daemon 

SYNOPSIS 

/etc/errstop [ namelist ] 

DESCRIPTION 

The error-logging daemon errdemon (1M) is terminated by 
using errstop. This is accomplished by executing ps(1) to 
determine the daemon's identity and then sending it a 
software kill signal [see signal {2)]\ /unlx is used as the system 
namelist if none is specified. Only the super-user may use 
errstop. 

FILES 

/unix default system namelist 

DIAGNOSTICS 

The diagnostics produced by errstop are intended to be self- 
explanatory. 

SEE ALSO 

errdemon (1M). 

ps(1) in the User's Reference Manual. 

kill{2), signal(2) in the Programmer's Reference Manual. 
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NAME 

ff - list file names and statistics for a file system 

SYNOPSIS 

/etc/ff [ options ] special 

DESCRIPTION 

Ff reads the Mist and directories of the special file, assuming 
it is a file system. I-node data is saved for files which match 
the selection criteria. Output consists of the path name for 
each saved i-node, plus other file information requested using 
the print options below. Output fields are positional. The out- 
put is produced in i-node order; fields are separated by tabs. 
The default line produced by ff is: 

path-name i- number 

With all options enabled, output fields would be: 

path-name i-number size uid 

The argument n in the option descriptions that follow is used 
as a decimal integer (optionally signed), where +n means 
more than n t -n means less than n, and n means exactly n. A 
day is defined as a 24 hour period. 

-I Do not print the i-node number after each path 

name. 

-I Generate a supplementary list of all path names 

for multiply-linked files. 

-p prefix The specified prefix will be added to each gen- 
erated path name. The default is . (dot). 

-s Print the file size, in bytes, after each path 

name. 

-u Print the owner's login name after each path 

name. 

•a n Select if the i-node has been accessed in n 

days. 

-m n Select if the i-node has been modified in n days. 

-c n Select if the i-node has been changed in n days. 

-n file Select if the i-node has been modified more 

recently than the argument file. 
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-i i-node-list Generate names for only those i-nodes specified 
in i-node-list. 

EXAMPLES 

To generate a list of the names of ail files on a specified file 
system: 

ff - 1 /dev/rdsk/c0d0s1 

To produce an index of files and i-numbers which are on a file 
system and have been modified in the last 24 hours: 

ff -m -1 /dev/c0d0s1 > /tog/fncbackup/usr/tuesday 

To obtain the path names for i-nodes 451 and 76 on a speci- 
fied file system: 

ff - f 451,76 /dev/rdsk/c0d1s3 

SEE ALSO 

frec(1M), ncheck(1M). 

find(1) in the User's Reference Manual. 

BUGS 

If the -I option is not specified, only a single path name out of 
all possible ones is generated for a multiply-linked i-node. If -I 
is specified, alt possible names for every linked file on the file 
system are included in the output. However, no selection cri- 
teria apply to the names generated. 

On very large file systems, memory may run out before ff 
does. 
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NAME 

free - recover files from a backup tape 
SYNOPSIS 

/etc/free [ -p path ] [ -f reqfile ] raw Jape ijiumber : 
name ... 

DESCRIPTION 

Free recovers files from the specified raw Jape backup tape 
written by vo/copy{1M), given their ijiumbers. The data for 
each recovery request will be written into the file given by 
name. 

The -p option allows you to specify a default prefixing path 
different from your current working directory. This will be pre- 
fixed to any names that are not fully qualified, that is to say, 
that do not begin with / or ./. If any directories are missing in 
the paths of recovery names they will be created. 

-p path Specifies a prefixing path to be used to fully qual- 
ify any names that do not start with / or ./. 

-f reqr7/e Specifies a file which contains recovery requests. 

The format is ijuimber: newname, one per line, 

EXAMPLES 

To recover a file, i-number 1216 when backed-up, into a file 
named junk in your current working directory: 

free /dev/rmtO 121 6: junk 

To recover files with ^numbers 14156, 1232, and 3141 into 
files /usr/sre/emd/a, /usr/sre/emd/b, and /usr/joe/a.c: 

free -p /usr/src/cmd /dev/rmtO 14156 :a 1232:b 
3111 :/usr/ joe/a. c 

SEE ALSO 

ff(1M), labelit(lM), volcopy(IM). 
cpio(1) in the User's Reference Manual, 
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BUGS 

While paving a path (that is to say, creating the intermediate 
directories contained in a pathname) free can only recover i- 
node fields for those directories contained on the tape and 
requested for recovery. 
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NAME 

fsck, dfsck, checkatl - check and repair file systems 
SYNOPSIS 

/etc/fsck [ -y ] [ -n ] [ -sc:s ] -s ] [ -Sc:s ] -S ] 
[ -t file ] 

[ -q ] [ -D ] [ -f ] [ -p ] [ -bB ] [ -O ] [ -M ] 

[ file-systems ] 

/etc/dfsck [ options 1 ] fsysl ... - [ options2 ] fsys2 ... 

checkall [ -amtvx ] [ -F flags ] [ fstab ] 

DESCRIPTION 
Fsck 

Fsck audits and interactively repairs inconsistent conditions for 
file systems. If the file system is found to be consistent, the 
number of files, number of blocks used, and number of blocks 
free are reported. If the file system is inconsistent, the user is 
prompted for concurrence before each correction is 
attempted. It should be noted that some corrective actions 
will result in some loss of data. The amount and severity of 
data loss may be determined from the diagnostic output. The 
default action for each correction is to wait for the user to 
respond yes or no. Upon completion fsck reports the number 
of used and free 1024-byte blocks and the number of files in 
the file system. 

Modifying a mounted (root) file system requires special pre- 
cautions by fsck, because a single sync (2) will undo all of 
fsck's repair work. To prevent this, fsck performs a syslo- 
ca/(2) RESYNC. The system call forces the operating system 
to reread the superblock from the disk. 

Fsck has more consistency checks that its predecessors 
check, dcheck, f check, and icheck combined. 

The following options are accepted by fsck, 

-y Assume a yes response to all questions asked by fsck, 

-n Assume a no response to all questions asked by fsck; do 
not open the file system for writing. 

-sc:s 

Ignore the actual free list or bit map and (unconditionally) 
reconstruct a new one by rewriting the super-block of the 
file system. The file system should be unmounted while 
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this is done; if this is not possible, care should be taken 
that the system is quiescent and that it is rebooted 
immediately afterwards. This precaution is necessary so 
that the old, bad, in-core copy of the superblock will not 
continue to be used, or be written on the file system. 

The -sc:s option allows for creating an optimal free-list 
organization. If c:s is given on a standard file system, the 
free list is organized with c blocks per cylinder and s 
blocks skipped. If c:s is not given, the values used when 
the file system was created are used. 

-Sc:s 

Conditionally reconstruct the free list. This option is like 
-sc:s above except that the free list or bit map is rebuilt 
only if there were no discrepancies discovered in the file 
system. Using -S will force a no response to all questions 
asked by fsck. This option Is useful for forcing free list 
reorganization on uncontamlnated file systems. 

-t If fsck cannot obtain enough memory to keep its tables, it 
uses a scratch file, If the -t option is specified, the file 
named in the next argument is used as the scratch file, if 
needed. Without the -t flag, fsck will prompt the user for 
the name of the scratch file, if needed. The file chosen 
should not be on the file system being checked, and if it 
is not a special file or did not already exist, it is removed 
when fsck completes. 

-q Quiet fsck. Do not print size-check messages. Unrefer- 
enced fifos will silently be removed. If fsck requires it, 
counts in the superblock will automatically be fixed and 
the free list or bit map salvaged. 

-D Directories are checked for consistency. Useful after sys- 
tem crashes. The following inconsistencies are sought: 

• Entries with null names but nonzero i-numbers. 

• Entries that are not padded to full size with nulls. 

• Invalid . and . . entries. 

• Names that contain. 

• Final blocks that are not cleared past end-of-file. 
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-f Fast check. Check block and sizes (Phase 1) and check 
the free list or bit map (Phase 5). The free list or bit map 
will be reconstructed (Phase 6) if necessary. 

-p Preen file systems only; Intended for auto boot. No 
operator input is prompted for. Instead, fsck applies stan- 
dard fixes whenever the fix doesn't involve loss of data. 
Only the following problems are subject to this kind of fix: 

• Unreferenced i-nodes. 

• Link counts in i-nodes too large. 

• Missing blocks in the free list. 

• Blocks in the free list also in files. 

• Counts in the superblock wrong. 

Any problem not of this type causes fsck to terminate 
with an error status. The startup script that runs fsck 
(normally /etc/bcheckrc) can specify the -p option to fsck 
and make a normal boot contingent upon a normal fsck 
return status, 

-b or -B 

If the file system was mounted, resync the file system 
after modifying it. This will cause the in-core superblock 
and i-nodes to be updated from the disk. This option 
should nearly always be used. 

-M Convert file system to new bit map free list format. 

-O Convert file system to old free list format. 

Both -M and -O imply -s (reconstruct free list and superblock). 

If no ff/e-sysfems are specified, fsck will read a list of default 
file systems from the file /etc/checklist. Note that this default 
check is provided for compatibility, and should not be used as 
the standard means of checking file systems. The list of file 
systems should be maintained in /etc/fstab, and checkall 
(rather than fsck) should be used to check all file systems. 

Inconsistencies checked are as follows: 

1. Blocks claimed by more than one i-node or the free list. 

2. Blocks claimed by an i-node or the free list outside the 
range of the file system, 

3. Incorrect link counts. 
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4. Size checks: 

• Incorrect number of blocks. 

• Directory size not 16-byte aligned. 

5. Bad i-node format. 

6. Blocks not accounted for anywhere. 

7. Directory checks: 

• File pointing to unallocated i-node. 

• I-node number out of range. 

8. Super Block checks: 

• More than 65536 i-nodes. 

• More blocks for i-nodes than there are in the file sys- 
tem. 

9. Bad free block list format. 

10. Total free block and/or free i-node count incorrect. 

Orphaned files and directories (allocated but unreferenced) 
are, with the user's concurrence, reconnected by placing them 
in the lost + found directory, if the files are nonempty. The 
user will be notified if the file or directory is empty or not. 
Empty files or directories are removed, as long as the -n 
option is not specified. Fsck will force the reconnection of 
nonempty directories. The name assigned is the i-node 
number. The only restriction is that the directory lost + found 
must preexist in the root of the file system being checked and 
must have empty slots in which entries can be made. This is 
accomplished either by using mklost+ found {lM) t or by mak- 
ing lost + found, then copying a number of files to the direc- 
tory and removing them (before fsck is executed). 

Checking the raw device is almost always faster and should be 
used with everything but the root file system. 

Dfsck 

This version of the fsck command is appropriate for computer 
systems equipped with more than one hard disk drive. Dfsck 
should not be used to check the roof file system. 

Dfsck allows two file system checks on two different drives 
simultaneously, Optionsl and options2 are used to pass 
options to fsck for the two sets of file systems. A - is the 
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separator between the file system groups. 

The dfsck program permits a user to interact with two fsck 
programs at once. To aid in this, dfsck will print the file sys- 
tem name for each message to the user. When answering a 
question from dfsck, the user must prefix the response with a 
1 or a 2 (indicating that the answer refers to the first or 
second file system group). 

Checkall 

Checkall checks all file systems listed in /etc/fstab, by running 
fsc/f(lM) on each one. Normally, only unmounted file systems 
are checked. The normal use of this command is to check the 
disks after a boot time fsck failure causes the system to enter 
ADMIN MODE (init state 5). 

Flags for use with checkall are: 

-v Specifies verbose mode; more information is displayed. 

-a Causes mounted file systems to be checked. 

-m Causes checkafl to mount each unmounted file system 
after it is checked. 

-x Causes mountall to exit immediately when any fsck fails. 

•F Causes the following flags to be passed to each invoca- 
tion of fsck (instead of the default flags -b -D). 

-t Causes the system to enter ADMIN MODE (init state 5) on 
any fsck failure. This flag is intended for use by the boot 
time scripts and should not be used otherwise. 

If the fstab argument is given, that file is used instead of 
/etc/fstab. 

NOTES 

The -b option should nearly always be used. 

The raw device should always be used with mounted file sys- 
tems. 

FILES 

/etc/checklist contains default list of file systems to 
check. 

/etc/fstab file system list. 
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SEE ALSO 

clri(lM), init{1M), mkfs(1M), mklost+ found (1M), ncheck(1M), 
crash (1M), 

checklist (4), fs(4) in the Programmer's Reference Manual. 
BUGS 

I-node numbers for . and . . in each directory are not checked 
for validity. 
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NAME 

fsdb - file system debugger 

SYNOPSIS 

/etc/fsdb special [ • ] 

DESCRIPTION 

Fsdb can be used to patch up a damaged file system after a 
crash. It has conversions to translate block and i-numbers 
into their corresponding disk addresses. Also included are 
mnemonic offsets to access different parts of an i-node. 
These greatly simplify the process of correcting control block 
entries or descending the file system tree. 

Fsdb contains several error-checking routines to verify i-node 
and block addresses. These can be disabled if necessary by 
invoking fsdb with the optional - argument or by the use of 
the O symbol. (Fsdb reads the i-size and f-size entries from 
the superbiock of the file system as the basis for these 
checks.) 

Numbers are considered decimal by default. Octal numbers 
must be prefixed with a zero. During any assignment opera- 
tion, numbers are checked for a possible truncation error due 
to a size mismatch between source and destination. 

Fsdb reads a block at a time and will therefore work with raw 
as well as block I/O. A buffer management routine is used to 
retain commonly used blocks of data in order to reduce the 
number of read system calls. All assignment operations result 
in an immediate write-through of the corresponding block. 

The symbols recognized by fsdb are: 



# absolute address 

I convert from i-number to i-node address 

b convert to block address 

d directory slot offset 

+ .-,*,/ 

address arithmetic 

q quit 

> , < save, restore an address 
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O 



P 
f 



X 



w 



F 



= + 



numerical assignment 
incremental assignment 
decremental assignment 
character string assignment 
error checking flip-flop 
general print facilities 
file print facility 
buffer status 

hexadecimal or octal address flip-flop (default is 
hexadecimal) B byte mode 

word mode 



D 



double word mode 



escape to shell 



The print facilities generate a formatted output in various 
styles. The current address Is normalized to an appropriate 
boundary before printing begins. It advances with the printing 
and is left at the address of the last item printed. The output 
can be terminated at any time by typing the delete character. 
If a number follows the p symbol, that many entries are 
printed. A check is made to detect block boundary overflows 
since logically sequential blocks are generally not physically 
sequential. If a count of zero Is used, all entries to the end of 
the current block are printed. 

The print options available are: 



i 


print as i-nodes 


d 


print as directories 


o 


print as octal words 


e 


print as decimal words 


c 


print as characters 


b 


print as octal bytes 


s or S 




print as superblock 
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x print as hexadecimal words 
h print as hexadecimal bytes 

The f symbol is used to print data blocks associated with the 
current i-node. If followed by a number, that block of the file 
is printed. (Blocks are numbered from zero.) The desired 
print option letter follows the block number, if present, or the f 
symbol. This print facility works for small as well as large files. 
It checks for special devices and that the block pointers used 
to find the data are not zero. 

Dots, tabs, and spaces may be used as function delimiters but 
are not necessary. A line with just a new-line character will 
increment the current address by the size of the data type last 
printed. That is, the address is set to the next byte, word, 
double word, directory entry, or i-node, allowing the user to 
step through a region of a file system. Information is printed 
in a format appropriate to the data type. Bytes, words, and 
double words are displayed with the octal address followed by 
the value in octal and decimal. A .B or .D is appended to the 
address for byte and double word values, respectively. Direc- 
tories are printed as a directory slot offset followed by the 
decimal i-number and the character representation of the 
entry name. I-nodes are printed with labeled fields describing 
each element. 

The following mnemonics are used for i-node examination and 
refer to the current working i-node: 

md mode 

In link count 

uid user ID number 

gid group ID number 

sz file size 

a# data block numbers (0 - 12) 

at access time 

mt modification time 

maj 

major device number 
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min 

minor device number 
si #i-nodes field in superbiock 
sf #blks field in superbiock 
sdO 

s_dinfo[0] in superbiock 

sd1 

s_dinfo[1] in superbiock 
= BS 

set a blank superbiock with file system type 1K and a 
magic number. 

EXAMPLES 

386 f prints i-number 386 in an i-node format. This 

now becomes the current working i-node. 

in=4 changes the link count for the working i-node 

to 4. 

in=+i increments the link count by 1. 

fc prints, in ASCII, block zero of the file associ- 

ated with the working i-node. 

2i.fd prints the first 32 directory entries for the root 

i-node of this file system. 

d5i.fc changes the current i-node to that associated 

with the 5th directory entry (numbered from 
zero) found from the above command. The 
first logical block of the file is then printed in 
ASCII. 

5i2B.poo prints the superbiock of this file system in 
octal. 

2i.aob.d7=3 changes the i-number for the seventh directory 
slot in the root directory to 3. This example 
also shows how several operations can be 
combined on one command tine. 

d7.nro="name" changes the name field in the directory slot to 
the given string. Quotes are optional when 
used with nm if the first character is alphabetic. 
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a2b.pod prints the third block of the current i-node as 

directory entries. 

512.ps prints the superblock. 

SEE ALSO 

fsck(1M). 

dir(4), fs(4) in the Programmer's Reference Manual. 
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NAME 

fsstat - report file system status 

SYNOPSIS 

/etc/fsstat specialjile 

DESCRIPTION 

Fsstat reports on the status of the file system on specialjile. 
During startup, this command is used to determine if the file 
system needs checking before it is mounted. Fsstat succeeds 
if the file system is unmounted and appears to be in good 
condition. For the root file system, it succeeds if the file sys- 
tem is active and not marked bad. 

SEE ALSO 

fs(4) in the Programmer's Reference Manual. 

DIAGNOSTICS 

The command has the following exit codes: 

0 the file system is not mounted and appears okay, (except 
for root where 0 means mounted and okay). 

1 the file system is not mounted and needs to be checked. 

2 the file system is mounted. 

3 the command failed. 
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NAME 

fstyp - determine fiie system identifier 

SYNOPSIS 
fstyp special 

DESCRIPTION 

Fstyp allows the user to determine the file system identifier of 
mounted or unmounted file systems using heuristic programs. 
The file system type is required by mount (1M) to mount file 
systems of different types. 

The directory /etc/fstyp.d contains a program for each file 
system type to be checked; each of these programs applies 
some appropriate heuristic to determine whether the supplied 
special file is of the type for which it checks. If it is, the pro- 
gram prints on standard output the usual file-system identifier 
for that type and exits with a return code of 0; otherwise it 
prints error messages on standard error and exits with a non- 
zero return code. Fstyp runs the programs in /etc/fstyp.d in 
alphabetical order, passing special as an argument; if any pro- 
gram succeeds, its file-system type identifier is printed and 
fstyp exits immediately. If no program succeeds, fstyp prints 
"Unknown^fstyp" to indicate failure. 

WARNING 

The use of heuristics implies that the result of fstyp is not 
guaranteed to be accurate. 

SEE ALSO 

mount (1M). 

mount(2), sysfs{2) in the Programmer's Reference Manual. 
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NAME 

fumount - forced unmount of an advertised resource 

SYNOPSIS 

fumount [ -w sec ] resource 

DESCRIPTION 

Fumount unadvertises resource and disconnects remote 
access to the resource. The -w sec causes a delay of sec 
seconds prior to the execution of the disconnect. 

When the forced unmount occurs, an administrative shell 
script is started on each remote computer that has the 
resource mounted (/usr/bin/rfuadmin). If a grace period of 
seconds is specified, rfuadmin is started with the fuwam 
option. When the actual forced unmount is ready to occur, 
rfuadmin is started with the fumount option. See rfuadmin (1M) 
for information on the action taken in response to the forced 
unmount. 

This command is restricted to the super-user. 
ERRORS 

If resource (1) does not physically reside on the local machine, 
(2) is an invalid resource name, (3) is not currently advertised 
and is not remotely mounted, or (4) the command is not run 
with super-user privileges, an error message will be sent to 
standard error. 

SEE ALSO 

adv(lM), mount(1M), rfuadmin{1M), rfudaemon(IM), 
rmount(lM), unadv(1M). 
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NAME 

fusage - disk access profiler 
SYNOPSIS 

fusage [ [ mount point ] J [ advertised_resource ] } 
[ block_special_device ][...]] 

DESCRIPTION 

When used with no options, fusage reports block I/O 
transfers, in kilobytes, to and from all locally mounted file sys- 
tems and advertised Remote File Sharing resources on a per 
client basis. The count data are cumulative since the time of 
the mount. When used with an option, fusage reports on the 
named file system, advertised resource, or block special dev- 
ice. 

The report includes one section for each file system and 
advertised resource and has one entry for each machine that 
has the directory remotely mounted, ordered by decreasing 
usage. Sections are ordered by device name; advertised 
resources that are not complete file systems will immediately 
follow the sections for the file systems they are in. 

SEE ALSO 

adv(1M), mount(1M), df(1M), crash(1M). 
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NAME 

fuser - identify processes using a file or file structure 
SYNOPSIS 

/etc/fuser [ -ku ] files j resources [ - ] [ [ -ku ] files J 
resources ] 

DESCRIPTION 

Fuser outputs the process IDs of the processes that are using 
the //7es or remote resources specified as arguments. Each 
process ID is followed by a letter code, interpreted as follows: 
if the process is using the file as (1) its current directory, the 
code is c, (2) the parent of its current directory (only when the 
file is being used by the system), the code is p, or (3) its root 
directory, the code is r. For block special devices with 
mounted file systems, all processes using any file on that dev- 
ice are listed. For remote resource names, all processes using 
any file associated with that remote resource (Remote File 
Sharing) are reported. {Fuser cannot use the mount point of 
the remote resource; it must use the resource name.) For all 
other types of files (text files, executables, directories, devices, 
and so forth) only the processes using that file are reported. 

The following options may be used with fuser: 

-u the user login name, in parentheses, also follows the pro- 
cess ID. 

-k the SIGKILL signal is sent to each process. Since this 
option spawns kills for each process, the kill messages 
may not show up immediately [see kill (2)]. 

If more than one group of files are specified, the options may 
be respecified for each additional group of files. A lone dash 
cancels the options currently in force; then, the new set of 
options applies to the next group of files. 

The process IDs are printed as a single line on the standard 
output, separated by spaces and terminated with a single new 
line. All other output is written on standard error. 

You cannot list processes using a particular file from a remote 
resource mounted on your machine. You can only use the 
resource name as an argument. 

Any user with permission to read /dev/kmem and /dev/mem 
can use fuser. Only the super-user can terminate another 
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user's process. 
FILES 

/unix for system namelist 

/dev/kmem for system image 
/dev/mem also for system image 

SEE ALSO 

mount(lM). 

ps(1) in the User's Reference Manual, 

kill (2), signal (2) in the Programmer's Reference Manual. 
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NAME 

gencc - create a front-end to the cc command 

SYNOPSIS 
gencc 

DESCRIPTION 

The gencc command is an interactive command designed to 
aid in the creation of a front-end to the cc command, Since 
hard-coded pathnames have been eliminated from the C 
Compilation System (CCS), it is possible to move pieces of the 
CCS to new locations without recompiling the CCS. The new 
locations of moved pieces can be specified through the -Y 
option to the cc command. However, it is inconvenient to 
supply the proper -Y options with every invocation of the cc 
command. Further, if a system administrator moves pieces of 
the CCS, such movement should be invisible to users. 

The front-end to the cc command which gencc generates is a 
one-Sine shell script which calls the cc command with the 
proper -Y options specified. The front-end to the cc com- 
mand will also pass all user-supplied options to the cc com- 
mand. 

Gencc prompts for the location of each tool and directory 
which can be respecified by a -Y option to the cc command. 
If no location is specified, it assumes that that piece of the 
CCS has not been relocated. After all the locations have been 
prompted for, gencc will create the front-end to the cc com- 
mand. 

Gencc creates the front-end to the cc command in the current 
working directory and gives the file the same name as the cc 
command. Thus, gencc can not be run in the same directory 
containing the actual cc command. Further, if a system 
administrator has redistributed the CCS, the actual cc com- 
mand should be placed somewhere which is not typically in a 
user's PATH (for example, /lib). This will prevent users from 
accidentally invoking the cc command without using the 
front-end. 

CAVEATS 

Gencc does not produce any warnings if a tool or directory 
does not exist at the specified location. Also, gencc does not 
actually move any files to new locations. 
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FILES 

./cc front- end to cc 

SEE ALSO 

cc(1). 
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NAME 

getty - set terminal type, modes, speed, and line discipline 
SYNOPSIS 

/etc/getty [ -h ] [ -t timeout ] line [ speed [ type 
[ linedisc ] ] ] 

/etc/getty -c file 

DESCRIPTION 

Getty is a program that is invoked by /n/f(1M). It is the second 
process in the series, {init-getty-login-shell) that ultimately 
connects a user with the 6000/50 system. It can only be exe- 
cuted by the super-user; that is, a process with the user-ID of 
root. Initially getty prints the login message field for the entry 
it is using from /etc/gettydefs. Getty reads the user's login 
name and invokes the /og//?(1) command with the user's name 
as argument. While reading the name, gerfy attempts to 
adapt the system to the speed and type of terminal being 
used, It does this by using the options and arguments speci- 
fied. 

Line is the name of a tty line in /dev to which getty is to 
attach itself. Getfy uses this string as the name of a file in the 
/dev directory to open for reading and writing. Unless getty is 
invoked with the -h flag, gerfy will force a hangup on the line 
by setting the speed to zero before setting the speed to the 
default or specified speed. The -t flag, plus timeout (in 
seconds), specifies that geffy should exit if the open on the 
line succeeds and no one types anything in the specified 
number of seconds. 

Speed, the optional second argument, is a label to a speed 
and tty definition in the file /etc/gettydefs. This definition tells 
getty at what speed to initially run, what the login message 
should look like, what the initial tty settings are, and what 
speed to try next should the user indicate that the speed is 
inappropriate (by typing a <break> character). The default 
speech is 9600 baud. 

Type, the optional third argument, is a character string 
describing to getty what type of terminal is connected to the 
line in question. Gerfy recognizes the following types: 

none default 
ds40-1 Dataspeed40/1 
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tektronix,tek 



Tektronix 
DEC vt61 
DEC vt100 



vt61 
vttOO 
hp45 
dOO 



Hewlett-Packard 45 
Concept 100 



The default terminal is none; that is to say, any CRT or normal 
terminal unknown to the system. Also, for terminal type to 
have any meaning, the virtual terminal handlers must be com- 
piled into the operating system. They are available but not 
compiled in the default condition. 

Linedisc, the optional fourth argument, is a character string 
describing which line discipline to use in communicating with 
the terminal. Again the hooks for line disciplines are available 
in the operating system but there is only one presently avail- 
able, the default line discipline, LDISCO. 

When given no optional arguments, getty sets the speed of 
the interface to 9600 baud, specifies that raw mode is to be 
used (awaken on every character), that echo is to be 
suppressed, either parity allowed, new-line characters will be 
converted to carriage return-line feed, and tab expansion per- 
formed on the standard output. It types the login message 
before reading the user's name a character at a time. If a null 
character (or framing error) is received, it is assumed to be 
the result of the user pushing the "break" key. This will cause 
geffy to attempt the next speed in the series. The series that 
geffy tries is determined by what it finds in /etc/gettydefs. 

After the user's name has been typed in, it is terminated by a 
new- line or carriage- return character. The latter results in the 
system being set to treat carriage returns appropriately [see 
ioctl{2)]. 

The user's name is scanned to see if it contains any lower- 
case alphabetic characters; if not, and if the name is non- 
empty, the system is told to map any future upper-case char- 
acters into the corresponding lower-case characters. 

In addition to the erase and kill characters # and @, getty also 
understands the standard System V erase and kill characters, 
\b and "U. If the user uses a \b as an erase, or "U as a kill 
character, getty sets the standard erase character and/or kill 
character to match. 
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Getty also understands the "standard" ESS protocols for eras- 
ing, killing, and aborting a line, and terminating a line. If getty 
sees the ESS erase character, or kill character, $, or abort 
character, &, or the ESS line terminators, / or ! , it arranges for 
this set of characters to be used for these functions. 

Finally, login is exec'd with the user's name as an argument. 
Additional arguments may be typed after the login name. 
These are passed to login, which will place them in the 
environment [see login (1)]. 

A check option is provided. When getty is invoked with the -c 
option and file, it scans the file as if it were scanning 
/etc/gettydefs and prints out the results to the standard out- 
put. If there are any unrecognized modes or improperly con- 
structed entries, it reports these. If the entries are correct, it 
prints out the values of the various flags. See /bcf/(2) to inter- 
pret the values. Note that some values are added to the flags 
automatically. 

FILES 

/etc/gettydefs 
/etc/issue 

SEE ALSO 

ct(lC), init(1M), tty(7). 

login (1) in the User's Reference Manual. 

ioctl(2), gettydefs{4), inittab(4) in the Programmer's Reference 

Manual. 

BUGS 

While getty understands simple single character quoting con- 
ventions, it is not possible to quote certain special control 
characters used by getty. Thus, you cannot login via getty 
and type a #, @, /, !, backspace, "U, "D, or & as part of 
your login name or arguments. Getty uses them to determine 
when the end of the line has been reached, which protocol is 
being used, and what the erase character is. They will always 
be interpreted as having their special meaning. 
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NAME 

hinv - hardware inventory 

SYNOPSIS 

/etc/hinv option 
/etc/hinv hardware- item 

DESCRIPTION 

Hinv provides hardware configuration information. It is used in 
one of two ways. For the first way, an option is given and the 
result is printed on stdout. The other way involves asking 
about a particular hardware item and hinv exiting with 0 if it 
exists and 1 otherwise. 



Option is one of the following; 



•p 


print hardware configuration. Items are printed one 




per line. 


•c 


print CPU type. 


-I 


print FPU type. 


-s 


print system type. 


-u 


print maximum number of users. 


-m 


print total physical memory in bytes. 


-M 


print total uncached memory in bytes. 


-t 


print number of tty ports on the system. 


-V 


print any of the above information verbosely. 


Hardware-item is one of the following: 


80387 


80387 floating-point processor. 


W1167 


Weitek 1167 floating point accelerator system. 



BUGS 

Hinv does not know about PC or PC/AT expansion cards. 
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NAME 

id - print user and group IDs and names 

SYNOPSIS 
id 

DESCRIPTION 

Id outputs the user and group IDs and the corresponding 
names of the invoking process. If the effective and real IDs 
are different, both are printed. 

SEE ALSO 

logname(t) in the User's Reference Manual. 
getuid(2) in the Programmer's Reference Manual. 
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NAME 

idload - Remote File Sharing user and group mapping 
SYNOPSIS 

idload [ -n ] [ -g gjules ] [ -u ujules ] [ directory ] 
DESCRIPTION 

Idload is used on Remote File Sharing server machines to 
build -translation tables for user and group IDs. It takes your 
/etc/passwd and /etc/group files and produces translation 
tables for user and group IDs from remote machines, accord- 
ing to the rules set down in the ujules and gjules files, If 
you are mapping by user and group name, you will need 
copies of remote /etc/passwd and /etc/group files. If no 
rules files are specified, remote user and group IDs are 
mapped to MAXUID + 1 (this is an ID number that is one 
higher than the highest number you could assign on your sys- 
tem.) 

By default, the remote password and group files are assumed 
to reside in /usr/nserve/auth.lnfo/o'oma/n/nosf/{passwd; 
group]. The directory argument indicates that some directory 
structure other than /usr/nserve/auth.info contains the 
domain /host passwd and group files. (Host is the name of 
the host the files are from and domain is the domain that host 
is a member of.) 

This command is run automatically when the first remote 
mount is done of a remote resource [see mount (1M)J. 

-n This is used to do a trial run of the ID mapping. 

No translation table will be produced; however, 
a display of the mapping is output to the termi- 
nal (stdout). 

-u ujules The ujules file contains the rules for user ID 
translation. The default rules file is 
/usr/nserve/auth.info/uid.rules. 

■9 9 Jules The gjules file contains the rules for group ID 
translation. The default rules file is 
/usr/nserve/auth.info/gid.rules. 

This command is restricted to the super-user. 

Rules 

The rules files have two types of sections, both optional: 
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global and host. There can be only one global section, 
though there can be one host section for each host you want 
to map. 

The global section describes the default conditions for transla- 
tion for any machines that are not explicitly referenced in a 
host section. If the global section is missing, the default 
action is to map all remote user and group IDs from undefined 
hosts to MAXUID + 1 . The syntax of the first line of the global 
section is: 

global 

A host section is used for each client machine or group of 
machines that you want to map differently from the global 
definitions. The syntax of the first line of each host section is: 

host name [ ... ] 

where name is replaced by the full name(s) of a host 
(domain.host). 

The format of a rules file is described below. (All lines are 
optional, but must appear in the order shown.) 

global 

default local J transparent 

exclude {remote Jd- remote Jd] \ [remote Jd] 

map [remote Jd -.local] 

host domain.hostname [domain.hostname . . .] 

default local \ transparent 

exclude [remofejoVemofejcH, { [remote Jd] \ 

[remotejiame] 
map [remote-local] \ remote J all 

Each of these instruction types is described below. 

The line: 

default local j transparent 

defines the mode of mapping for remote users that are not 
specifically mapped in instructions in other lines. Transparent 
means that all remote user and group IDs will have the same 
numeric value locally unless they appear in the exclude 
instruction. Local can be replaced by a local user name or ID 
to map all users into a particular local name or ID number. If 
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the default line is omitted, ail users that are not specifically 
mapped are mapped into a "special guest" login ID. 

The line: 

exclude [remotejd-remotejd] \ [remotejd] \ 
[remote_name] 

defines remote IDs that will be excluded from the default 
mapping. The exclude instruction must precede any map 
instructions in a block. You can use a range of ID numbers, a 
single ID number, or a single name. {Remotejtame cannot be 
used in a global block.) 

The line: 

map [remote:local] | remote j ail 

defines the local IDs and names that remote IDs and names 
will be mapped into. Remote is either a remote ID number or 
remote name; local is either a local ID number or local name. 
Placing a colon between a remote and a local will give the 
value on the left the permissions of the value on the right. A 
single remofe name or ID will assign the user or group permis- 
sions of the same local name or ID. All is a predefined alias 
for the set of all user and group IDs found in the local 
/etc/passwd and /etc/group files. (You cannot map by 
remote name in global blocks.) 

Note: idload will always output warning messages for map all, 
since password files always contain multiple administrative 
user names with the same ID number. The first mapping 
attempt on the ID number will succeed, all subsequent 
attempts will fail. 

Remote File Sharing doesn't need to be running to use idload. 
EXIT STATUS 

On successful completion, idload will produce one or more 
translation tables and return a successful exit status. If idload 
fails, the command will return an unsuccessful exit status 
without producing a translation table. 

ERRORS 

If (1) neither of the rules files can be found or opened, (2) 
there are syntax errors in the rules file, (3) there are semantic 
errors in the rules file, (4) host information could not be found, 
or (5) the command is not run with super-user privileges, an 
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error message will be sent to standard error. Partial failures 
will cause a warning message to appear, though the process 
will continue. 

FILES 

/etc/passwd 
/etc/group 

/usr/nserve/auth.inf o/domainjhost ([user \ group] 
/usr/nserve/auth.info/vid. rules 
/usr/nserve/auth.info/gid.rules 

SEE ALSO 

mount(1M). 
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NAME 

infocmp - compare or print out terminfo descriptions 
SYNOPSIS 

infocmp [ -d ] [ -c ] [ -n ] [ -I ] [ -L ] [ -C ] [ -r ] 
[ -u ] 

[ -s d { i I I ; c ] [ -v ] [ -V ] [ -1 ] [ -w width ] 
[ -A directory ] [ -B directory ] [ termname ... ] 

DESCRIPTION 

Infocmp can be used to compare a binary rerm/nfo(4) entry 
with other terminfo entries, rewrite a terminfo (4) description to 
take advantage of the use= terminfo field, or print out a ter- 
minfo (4) description from the binary file [ferm{4)] in a variety 
of formats, in all cases, the boolean fields will be printed first, 
followed by the numeric fields, followed by the string fields. 

Default Options 

If no options are specified and zero or one termnames are 
specified, the -I option will be assumed. If more than one 
termname is specified, the -d option will be assumed. 

Comparison Options 

Infocmp compares the terminfo (4) description of the first ter- 
minal termname with each of the descriptions given by the 
entries for the other terminal's termnames. If a capability is 
defined for only one of the terminals, the value returned will 
depend on the type of the capability: F for boolean variables, 
-1 for integer variables, and NULL for string variables. 

-d produce a list of each capability that is different. In this 
manner, if one has two entries for the same terminal or 
similar terminals, using infocmp will show what is different 
between the two entries. This is sometimes necessary 
when more than one person produces an entry for the 
same terminal and one wants to see what is different 
between the two. 

-c produce a list of each capability that is common between 
the two entries. Capabilities that are not set are ignored. 
This option can be used as a quick check to see if the -u 
option is worth using. 

-n produce a list of each capability that is in neither entry. If 
no termnames are given, the environment variable TERM 
will be used for both of the termnames. This can be used 
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as a quick check to see if anything was left out of the 
description. 

Source Listing Options 

The -I, -L, and -C options will produce a source listing for 
each terminal named. 

-I use the terminfo (4) names 

•L use the long C variable name listed in <term.h> . 

-C use the termcap names. 

-r when using -C, put out all capabilities in termcap form. 

If no termnames are given, the environment variable TERM 
will be used for the terminal name. 

The source produced by the -C option may be used directly 
as a termcap entry, but not all of the parameterized strings 
may be changed to the termcap format. Infocmp will attempt 
to convert most of the parameterized information, but that 
which it doesn't will be plainly marked in the output and com- 
mented out. These should be edited by hand. 

All padding information for strings will be collected together 
and placed at the beginning of the string where termcap 
expects it. Mandatory padding (padding information with a 
trailing V) will become optional. 

All termcap variables no longer supported by terminfo (4), but 
which are derivable from other terminfo {4) variables, will be 
output. Not all terminfo (4) capabilities will be translated; only 
those variables which were part of termcap will normally be 
output. Specifying the -r option will take off this restriction, 
allowing all capabilities to be output in termcap form. 

Note that because padding is collected to the beginning of the 
capability, not all capabilities are output, mandatory padding is 
not supported, and termcap strings were not as flexible, it is 
not always possible to convert a terminfo{4) string capability 
into an equivalent termcap format. Not all of these strings will 
be able to be converted. A subsequent conversion of the 
termcap file back into terminfo (4) format will not necessarily 
reproduce the original terminfo {4) source. 

Some common terminfo parameter sequences, their termcap 
equivalents, and some terminal types which commonly have 
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such sequences, are: 



Terminfo 


Termcap 


Representative Terminals 


%p1%c 


%. 


adm 




%d 


hp, ANSI standard, vt100 


%p1%'x'% + %c 


%+x 


concept 


%i 


%i 


ANSI standard, vttOO 


%p1 %?%Y% > %t%p1 %y% + %; 


%>xy 


concept 


%p2 is printed before %p1 


%r 


hp 



Use= Option 

-u produce a terminfo{4) source description of the first 
terminal termname which is relative to the sum of the 
descriptions given by the entries for the other termi- 
nals termnames. It does this by analyzing the differ- 
ences between the first termname and the other rerm- 
names and producing a description with use= fields 
for the other terminals. In this manner, it is possible 
to retrofit generic terminfo entries into a terminal's 
description. Or, if two similar terminals exist, but 
were coded at different times or by different people 
so that each description is a full description, using 
infocmp will show what can be done to change one 
description to be relative to the other. 

A capability will get printed with an at-sign (@) if it no longer 
exists in the first termname, but one of the other termname 
entries contains a value for it. A capability's value gets printed 
if the value in the first termname is not found in any of the 
other termname entries, or if the first of the other termname 
entries that has this capability gives a different value for the 
capability than that in the first termname. 

The order of the other termname entries is significant. Since 
the terminfo compiler r7c(1M) does a left-to-right scan of the 
capabilities, specifying two use= entries that contain differing 
entries for the same capabilities will produce different results 
depending on the order in which the entries are given. 
Infocmp will flag any such inconsistencies between the other 
termname entries as they are found. 

Alternatively, specifying a capability after a use= entry that 
contains that capability will cause the second specification to 
be ignored. Using infocmp to recreate a description can be a 
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useful check to make sure that everything was specified 
correctly in the original source description. 

Another error that does not cause incorrect compiled files, but 
will slow down the compilation time, is specifying extra use = 
fields that are superfluous. Infocmp will flag any other term- 
name use= fields that were not needed. 

Other Options 

-s sort the fields within each type according to the argument 
below: 

d leave fields in the order that they are stored in the 
terminfo database. 

i sort by terminfo name. 

I sort by the long C variable name. 

c sort by the termcap name. 

If no -s option is given, the fields printed out will be 
sorted alphabetically by the terminfo name within each 
type, except in the case of the -C or the -L options, which 
cause the sorting to be done by the termcap name or the 
long C variable name, respectively. 

-v print out tracing information on standard error as the pro- 
gram runs. 

-V print out the version of the program in use on standard 
error and exit. 

-1 cause the fields to printed out one to a line. Otherwise, 
the fields will be printed several to a line to a maximum 
width of 60 characters. 

-w change the output to width characters. 

Changing Databases 

The location of the compiled terminfo (4) database is taken 
from the environment variable TERMINFO. If the variable is 
not defined, or the terminal is not found in that location, the 
system terminfo {A) database, usually in lusr/lib/terminfo, will 
be used. The options -A and -B may be used to override this 
location. The -A option will set TERMINFO for the first term- 
name and the -B option will set TERMINFO for the other 
termnames, With this, it is possible to compare descriptions 
for a terminal with the same name located in two different 
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databases. This is useful for comparing descriptions for the 
same terminal created by different people. Otherwise the ter- 
minals would have to be named differently in the terminfo{4) 
database for a comparison to be made. 

FILES 

/usr/lib/terminfo/?/* compiled terminal description database 

DIAGNOSTICS 

malloc is out of space! 

There was not enough memory available to process all the 
terminal descriptions requested. Run infocmp several 
times, each time including a subset of the desired term- 
names. 

use ~ order dependency found: 

A value specified in one relative terminal specification was 
different from that in another relative terminal specifica- 
tion, 

'use = term' did not add anything to the description. 

A relative terminal name did not contribute anything to 
the final description. 

must have at least two terminal names for a comparison 
to be done. 

The -u, -d and -c options require at least two terminal 
names. 

SEE ALSO 

tic(lM), curses(3X), term(4), terminfo(4) in the Programmer's 
Reference Manual. 

captoinf o(1 M) in the Administrator's Reference Manual. 
"curses/terminfo" in the System V Operating System 
Programmer's Guide. 

NOTE 

The termcap database (from earlier releases of UNIX System 
V) may not be supplied in future releases. 
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NAME 

init, telinit - process control initialization 

SYNOPSIS 

/etc/init [ 0123456SsQq ] 

/etc/telinit [ 0123456sSQqabc ] 

DESCRIPTION 
Init 

Init is a general process spawner. Its primary role is to create 
processes from information stored in the file /etc/inittab [see 
inittab{4)]. This file usually has init spawn getty's on each line 
that a user may log in on. It also controls autonomous 
processes required by any particular system. 

Init considers the system to be in a run-level at any given 
time. A run-level can be viewed as a software configuration of 
the system where each configuration allows only a selected 
group of processes to exist. The processes spawned by init 
for each of these run-levels is defined in the inittab file. Init 
can be in one of eight run-levels, 0-6 and S or s. The run- 
level is changed by having a privileged user run /etc/init. This 
user-spawned init sends appropriate signals to the original init 
spawned by the operating system when the system was 
rebooted, telling it which run- level to change to. 

Init is invoked inside the 6000/50 system as the last step in the 
boot procedure. First init looks in /etc/inittab for the initde- 
fault entry [see inittab {4)]. If there is one, init uses the run- 
level specified in that entry as the initial run-level to enter. If 
this entry is not in /etc/inittab, init requests that the user enter 
a run-level from the virtual system console, /dev/console. If 
an S or an s is entered, init goes into the SINGLE USER state. 
This is the only run-tevei that doesn't require the existence of 
a properly formatted /etc/inittab file. If it doesn't exist, then 
by default the only legal run-level that init can enter is the 
SINGLE USER state. In the SINGLE USER state the virtual 
console terminal /dev/consoie is opened for reading and writ- 
ing and the command /bin/su is invoked immediately. To exit 
from the SINGLE USER state, use either init or telinit to signal 
init to change the run-level of the system. Note that if the 
shell is terminated {via a control- d), init will only re-initialize to 
the SINGLE USER state. 
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When attempting to boot the system, failure of init to prompt 
for a new run-level may be due to the fact that the device 
/dev/console is linked to a device other than the physical sys- 
tem console (/dev/contty). If this occurs, init can be forced to 
relink /dev/console by typing a delete on the system console 
which is colocated with the processor. 

When init prompts for the new run-level, the operator may 
enter only one of the digits 0 through 6 or the letters S or s. 
If S or s is entered, init operates as previously described in 
the SINGLE USER state with the additional result that 
/dev/console is linked to the user's terminal line, thus making 
it the virtual system console. A message is generated on the 
physical console, /dev/contty, saying where the virtual termi- 
nal has been relocated. 

When init comes up initially and whenever it switches out of 
SINGLE USER state to normal run states, it sets the ioctl{2) 
states of the virtual console, /dev/console, to those modes 
saved in the file /etc/ioctl.syscon. This file is written by init 
whenever the SINGLE USER state is entered. If this file does 
not exist when init wants to read it, a warning is printed and 
default settings are assumed. 

If a 0 through 6 is entered init enters the corresponding run- 
level. Any other input will be rejected and the user will be re- 
prompted. Note that, on the 6000/50, run-level 0 is for shut- 
ting down the system; run-level 1 is the single-user state; run- 
levels 2 and 3 are available as normal operating states; run- 
level 4 is undefined, run-level 5 is for administration, and run- 
tevel 6 is for reboot. 

If this is the first time init has entered a run-level other than 
SINGLE USER, init first scans inittab for special entries of the 
type boot and bootwait. These entries are performed, provid- 
ing the run-level entered matches that of the entry before any 
normal processing of inittab takes place. In this way any spe- 
cial initialization of the operating system, such as mounting file 
systems, can take place before users are allowed onto the 
system. The inittab file is scanned to find all entries that are 
to be processed for that run-level. 

Run-level 2 is defined to contain all of the terminal processes 
and daemons that are spawned in the multi-user environment. 
Hence, it is commonly referred to as the MULTI-USER state. 
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Run-level 3 is defined to start up remote file sharing 
processes and daemons as well as mount and advertise 
remote resources. So, run-level 3 extends multi-user mode 
and is know as the Remote File Sharing state. 

In a MULTI-USER environment, the inittab file is set up so that 
init will create a process for each terminal on the system that 
the administrator sets up to respawn. 

For terminal processes, ultimately the shell will terminate 
because of an end-of-file either typed explicitly or generated 
as the result of hanging up. When init receives a signal telling 
it that a process it spawned has died, it records the fact and 
the reason it died in /etc/utmp and /etc/wtmp if it exists [see 
who (1)]. A history of the processes spawned is kept in 
/etc/wtmp. 

To spawn each process in the inittab file, init reads each entry 
and for each entry that should be respawned, it forks a child 
process. After it has spawned all of the processes specified 
by the inittab file, init waits for one of its descendant 
processes to die, a powerfail signal, or until init is signaled by 
init or telinit to change the system's run- level. When one of 
these conditions occurs, init re-examines the inittab file. New 
entries can be added to the inittab file at any time; however, 
init still waits for one of the above three conditions to occur. 
To get around this, init Q or init q command wakes init to re- 
examine the inittab file immediately. 

If init receives a powerfail signal (SIGPWR) it scans inittab for 
special entries of the type powerfail and powerwait. These 
entries are invoked (if the run-levels permit) before any further 
processing takes place. In this way init can perform various 
cleanup and recording functions during the powerdown of the 
operating system. Note that in the SINGLE- USER state only 
powerfail and powerwait entries are executed. 

When init is requested to change run-levels (via telinit), init 
sends the warning signal (SIGTERM) to all processes that are 
undefined in the target run- level. Init waits 20 seconds before 
forcibly terminating these processes via the kill signal (SIG- 
KILL). 

Telinit 

Telinit, which is linked to letcfinit, is used to direct the actions 
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of init. It takes a one-character argument and signals init via 
the kill system call to perform the appropriate action. The fol- 
lowing arguments serve as directives to init. 

0-6 tells init to place the system in one of the run-levels 
0-6. 

a.b.c tells init to process only those /etc/inittab file entries 
having the a, b or c run-level set. These are 
pseudo-states, which may be defined to run certain 
commands, but which do not cause the current run- 
level to change. 

Q,q tells init to re-examine the /etc/inittab file. 

s,S tells init to enter the single user environment. When 
this level change is effected, the virtual system tele- 
type, /dev/console, is changed to the terminal from 
which the command was executed. 

FILES 

/etc/inittab 

/etc/utmp 

/etc/wtmp 

/etc/ioctl.syscon 

/dev/console 

/dev/contty 

SEE ALSO 

getty(1M), termio(7). 

login (1), sh(1), who(1) in the User's Reference Manual. 

kill(2), inittab{4), utmp(4) in the Programmer's Reference 

Manual. 

DIAGNOSTICS 

If init finds that it is res pawning an entry from /etc/inittab 
more than 10 times in 2 minutes, it will assume that there is an 
error in the command string in the entry, and generate an 
error message on the system console. It will then refuse to 
respawn this entry until either 5 minutes has elapsed or it 
receives a signal from a user-spawned init {telinit). This 
prevents init from eating up system resources when someone 
makes a typographical error in the inittab file or a program is 
removed that is referenced in the inittab file. 
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WARNINGS 

Telinit can be run only by someone who is super-user or a 
member of group sys. 

BUGS 

Attempting to relink /dev/console with /dev/contty by typing 
a delete on the system console does not work. 
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NAME 

install - install commands 

SYNOPSIS 

/etc/install [ -c dira ] [ -f dirb ] [ -i ] [ -n dire ] 

[ -m mode ] [ -u user ] [ -g group 3 [ -o ] [ -s ] file 

[ dirx ... J 

DESCRIPTION 

The install command is most commonly used in "makefiles" 
[see mafce(1)] to install a file (updated target file) in a specific 
place within a file system. Each file is installed by copying it 
into the appropriate directory, thereby retaining the mode and 
owner of the original command. The program prints mes- 
sages telling the user exactly what files it is replacing or creat- 
ing and where they are going. 

If no options or directories (dirx ...) are given, install will 
search a set of default directories (/bin, /usr/bin, /etc, /lib, 
and /usr/lib t in that order) for a file with the same name as 
file. When the first occurrence is found, install issues a mes- 
sage saying that it is overwriting that file with file, and 
proceeds to do so. If the file is not found, the program states 
this and exits without further action. 

If one or more directories {dirx ...) are specified after file, 
those directories will be searched before the directories speci- 
fied in the default list. 

The meanings of the options are: 

-c dira Installs a new command (file) in the directory speci- 
fied by dira t only if it is not found. If it is found, 
install issues a message saying that the file already 
exists, and exits without overwriting it. May be 
used alone or with the -s option. 

-f dirb Forces file to be installed in given directory, 
whether or not one already exists. If the file being 
installed does not already exist, the mode and 
owner of the new file will be set to 755 and bin, 
respectively. If the file already exists, the mode 
and owner will be that of the already existing file. 
May be used alone or with the -o or -s options. 
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-i Ignores default directory list, searching only 

through the given directories {dirx ...). May be 
used alone or with any other options except -c and 
-f. 

•n dire If file is not found in any of the searched direc- 
tories, it is put in the directory specified in dire. 
The mode and owner of the new file will be set to 
755 and bin, respectively. May be used alone or 
with any other options except -c and -f. 

-m mode The mode of the new file is set to mode. Only 
available to the super-user. 

-u user The owner of the new file is set to user. Only avail- 
able to the super-user. 

-g group The group ID of the new file is set to group. Only 
available to the super-user. 

-o If file is found, this option saves the "found" file by 

copying it to OLDf/Ve in the directory in which it was 
found. This option is useful when installing a fre- 
quently used file such as /bin/sh or /etc/getty, 
where the existing file cannot be removed. May be 
used alone or with any other options except -c. 

-s Suppresses printing of messages other than error 

messages. May be used alone or with any other 
options. 

SEE ALSO 

make(1) in the Programmer's Reference Manual. 
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NAME 

kcrash - examine system Images 

SYNOPSIS 

kcrash [-w] dumpfile [ namelist j 

DESCRIPTION 

The kcrash program, similar to the crash (iM) program, exam- 
ines system crash dumps. Unlike crash, the kcrash command 
interface is based on the kernel debugger [see kdb^M}]. All 
commands accepted by the kernel debugger can be used 
identically in kcrash, with the following exceptions: 

• I/O commands (such as in, out, and so forth) do not work. 

• Execution commands (go, tr, to) do not work. 

• Breakpoint commands do nothing. 

• The rc command does not work. 

Commands that modify memory (actually modify the crash 
dump file) work only if the -w flag is present in the command 
line. 

In addition, the following commands work only in kcrash (not 
in the kernel debugger): 

< < filename 

Read and execute commands from the given file. Note 
that the < < command is like the combination of 
mkdbcmd^M) and the rc command in the kernel 
debugger. 

I! shell-command 

Executes the given shell command. 

qq Quits kcrash. 
FILES 

/crash/crash.* crash dumps 
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/crash/macros/* macros that are useful for kernel debugging 
/unix default namelist 

SEE ALSO 

crash(1M), kdb(lM). 
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NAME 

kdb - Kernel Debug Monitor 
DESCRIPTION 

The 6000/50 Debug Monitor is a simple monitor that resides in 
the System V kernel and allows the programmer to examine 
and modify memory, disassemble instructions, download and 
execute programs, set breakpoints, and single-step instruc- 
tions. 

After loading the debug monitor with /o*o7v(1M), the monitor is 
entered by typing control-B on the console [see cons (1M)]. 

Commands 

All monitor commands are two characters, followed by zero or 
more arguments. In the following descriptions, optional argu- 
ments are enclosed in square brackets. Arguments are 
separated by spaces or commas, and each argument must be 
one of the following: 

1. A hex number. 

2. A percent sign followed by a register name, meaning the 
contents of that register, such as %eax, %esp, %eflags. 
Only 32-bit registers are allowed; 8- or 16-bit registers are 
invalid. 

A percent sign followed by a breakpoint number, meaning the 
address referred to by the that breakpoint, such as %bx. 

3. A dollar sign, meaning the address of the last memory 
location that was displayed. 

4. The name of a kernel symbol. This works only if the ker- 
nel debugger has been loaded with the System V symbol 
table via the mkdbsym (1M) command. 

5. Any of the above combined by using the usual arithmetic 
operators (+-*/% & { *) or the relational operators 
used as used in the C programming language ( = = ! = 
<> <- >-), All operators have equal precedence. 
Use parentheses to force a particular order of evaluation. 

Input Commands 

The debug monitor prompts with K>. This prompt indicates 
the monitor is ready to accept any of the commands 
described below. Input characters can be erased with BACK- 
SPACE or DEL. An entire input line can be erased with 
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controt-U or control-X. 

After a breakpoint or debug trap, the monitor prints a status 
line describing the trap, immediately followed by the K 
prompt, and is again ready to accept commands. In the case 
of a trace trap, the monitor automatically supplies the 
expected command, tr. If you want to enter a different com- 
mand, erase the tr and retype a new command. 

During any of the display, modify, examine or write com- 
mands, you can enter one of the following: 

RETURN 

Moves to the next item. 

+n Moves to the nth next item. 

Moves to the previous item. 

-n Moves to the nth previous item. 

=addr 

Moves to the item at address addr. Only valid when 
operating on memory, not on registers. 

n Changes the value of the item to n. Only valid for modify 
or write commands, not display or examine. The mi com- 
mand allows you to enter multiple numbers separated by 
spaces, to change more than one byte. 

q (Or any character other than + - = or a hex number). 
Exits the command and returns to the monitor prompt. 

Display Commands 

These commands allow you to examine memory only. This 
prevents accidental modification of system memory when in 
the debug monitor. 

dl addr [ count ] 

Displays memory as longs (4 byte hex integers), 32 bytes 
at a time. If a count is given, memory is displayed 32 * 
count bytes at a time. 
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dw addr [ count ] 

Displays memory as words (2 byte hex integers), 32 bytes 
at a time. 

db addr [ count ] 

Displays memory as bytes (1 byte hex integers), 32 bytes 
at a time. 

di [addr] 

Displays memory as disassembled instructions. The 
default addr is the contents of %eip. 

dr Displays the CPU general registers. 

dR Displays the CPU "special" registers (debug, control, and 
table base registers). 

dy addr [ count ] 

Similar to di, but displays the longs in symbolic form, if 
possible. 

se start end pattern { mask ] 

Searches for the given pattern in the range of addresses 
starting at start, up to (but not including) end. The 
search is performed on longs. If a mask is given, only 
those bits corresponding to 1 bits in the mask are signifi- 
cant in the search. 

Examine Commands 
el addr 

Examines memory as longs, one at a time, 
ew addr 

Examines memory as words, one at a time, 
eb addr 

Examines memory as bytes, one at a time, 
ei [ addr ] 

Examines memory as disassembled instructions. (Same 
as di.) 

er Examines CPU general registers, one at a time. 

eR Examines the CPU special registers, one at a time. 

Modify Commands 
ml addr 

Examines and optionally modifies memory, as longs. 
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mw addr 

Examines and optionally modifies memory, as words, 
mb addr 

Examines and optionally modifies memory, as bytes, 
mi [ addr ) 

Examines memory as instructions and optionally modifies 
(as bytes). 

mr Examines and optionally modifies the CPU registers. 

mR Examines and optionally modifies the CPU special regis- 
ters. 

Write Commands 
wl addr 

Writes memory as longs, without examining, 
ww addr 

Writes memory as words, without examining, 
wb addr 

Writes memory as bytes, without examining. 

I/O Commands 
in addr 

Reads a byte from the specified I/O port. 
Iw addr 

Reads a word (2 bytes) from the specified I/O port, 
it addr 

Reads a longword (4 bytes) from the specified I/O port. 

ou addr value 

Outputs a byte {value) to the specified I/O port. 

ow addr value 

Outputs a word {value) to the specified I/O port. 

ol addr value 

Outputs a longword {value) to the specified I/O port. 

Execute Commands 
go [ addr ] 

Starts execution. 

tr [ addr } 

Trace: single step one instruction. 
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to [ addr ] 

Trace over: single step over "call" instructions. 
Breakpoint Commands 

A breakpoint invokes the debug monitor just prior to the exe- 
cution of a specified instruction. There are a total of sixteen 
instruction breakpoints available. 

br [ addr J 

Sets a breakpoint. The default address is the contents of 
%eip. 

be [ addr ] 

Clears (removes) a breakpoint. 

bC [ addr } 

Clears (removes) all breakpoints. 

bx [ addr ] 

Sets a temporary (one-shot) breakpoint. 

bo [ addr ] 

Turns a breakpoint on or off. If a breakpoint is turned off, 
it acts as though it were cleared, but the breakpoint 
remains in the breakpoint table. 

bp Displays breakpoints. 

Memory Breakpoint Commands 

A memory breakpoint invokes the debug monitor when a 
specified memory location is referenced. There are a total of 
four memory breakpoints available. 

ur num type [ addr ] 

Sets a memory breakpoint. Num must be 0 to 3, addr is 
the breakpoint address, and type gives the type of 
memory access that will trigger the breakpoint. Valid 
types are: 

0 Execute 

10 Byte write 

1 1 Byte read/write 

20 Word write 

21 Word read/write 

40 Long write 

41 Long read/write 
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Note that the first digit specifies the breakpoint length 
and the second specifies the access type (write-oniy or 
read/write). The breakpoint is global unless the type is 
ORed with 100, which makes it local; or with 200, which 
makes it global and local. For example, 140 specifies a 
local long write-only breakpoint. 

ux num type [ addr ] 

Like ur, but sets a temporary (one-shot) breakpoint. 

uc num 

Clears a memory breakpoint. 

up Prints all memory breakpoints. 

Miscellaneous Commands 
bt [ addr ] 

Displays a stack backtrace, using addr as a frame pointer. 
The default address is the contents of %ebp. This works 
only with C language routines in protected mode. 

fi start end value 

Fills memory from address start up to (but not including) 
address end with the byte value. 

pg "string" [ args... J 

Prints the string. Percent signs in the string are treated 
as in printf(Z§): %d, %u, %x, %o, %b, %s, %s, %c are 
supported. 

In addition, %y prints its argument in symbolic form, if possi- 
ble. 

rc Reads any commands that have been loaded previously 
with the mkdbcmd (1M) command. 

rg [ addr ) 

Changes the pointer to the "register save area," from 
which ail references to CPU registers, such as the dr com- 
mand, and explicit reference, such as %ebx, or an implicit 
reference, such as the dl command with no argument, 
retrieve registers. Normally, the register save area is set 
up automatically, but you can use a different set of regis- 
ters when you use rg to change the pointer. 

P9 [ n] 

If n is 0, turns paging off. If n is 1, turns paging on. If n 
is missing, it simply reports whether paging is on or off. If 
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paging is off, the monitor interprets all addresses as phy- 
sical addresses. If paging is on, addresses are inter- 
preted as linear (virtual) addresses, (Breakpoints are 
always linear addresses.) 

ma addr 

Displays the page directory and page table entries used 
to map the given linear address to a physical address. 
This behaves the same whether paging is on or off, 

c3 addr 

Uses the given physical address as the base of the page 
directory for translating linear to physical addresses. This 
address is obtained from the special register CR3 if no c3 
command is given. 

pr addr 

Prints the value of the address given as an argument. 
This is most useful if addr is an expression (see the earlier 
discussion of arguments). 

ds addr 

Prints the value of the address as an offset from the 
nearest symbol. 

sy I n ] [ max ] 

If n is 0, turns symbolic display off. If n is 1, turns sym- 
bolic display on. If n is missing, it simply reports whether 
symbolic display is on or off. If max is given, it specifies 
the maximum offset for printing symbols. For example, if 
max is 1000, a symbol may be displayed in the form 
name+NNN, where NNN is 1 through 1000, but if NNN 
would be greater than 1000, the non-symbolic display for- 
mat is used. 

he or ?? 

Lists the monitor commands. 

ve Prints the version number of the monitor. 

Macro Commands 

dm "name" arg-count 

Defines a MACRO, with the given name and the specified 
number of arguments. The cm command (described 
below) can be used subsequently to invoke the macro. 
After you enter the dm command, the debugger prompts 
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with mao for the body of the macro. Any debugger 
commands can be entered as the body of the macro, 
although interactive commands, such as di are not recom- 
mended. The expression $n, where n is a digit from 1 to 
9, is replaced on invocation with the nth argument to the 
macro. Entry of the macro body is terminated by a period 
(.) anywhere in the macro body. Include a period in the 
macro body by preceding the character with a backslash 
\.. 

cm "name" args 

Calls a macro. The number of arguments must match the 
number given when the macro was defined. The effect is 
as if the body of the macro were entered in place of the 
cm command. 

em "name" 

Erases (deletes) the named macro. 

im ["name"] 

Lists the named macro. If the macro name is omitted, 
lists all macros. 

nx Repeats the call to the previously invoked macro. The 
arguments used ar the ones used on the previous call, 
possibly modified by any intervening sa commands. 

sa n value 

Sets the nth macro argument to the given value. The 
value of n should be between 1 and 9. Useful within a 
macro to set up the arguments for the next call through 
an nx commmand. 

ec [n] 

If n is 1, macros are echoed when they are invoked. If n 
is 0 (the default), macros are not echoed. If n is missing, 
the status of the echo flag is printed. If the ec command 
is given within a macro body, it is in effect only for that 
macro. 

Conditional Commands 
IF expr EL FI 

If the expression evaluates to zero, all commands up to 
the matching EL or FI are skipped. If the expression is 
non-zero, execution proceeds normally to the matching 
FI, unless a matching EL is found, in which case, 
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commands between the EL and the FI are skipped. Dur- 
ing any of this "skipping," the prompt changes from K > 
to \mK> to indicate that the commands are being read 
but not executed. 

SEE ALSO 

cons(lM), lddrv(1M), mkdbsym(tM) in the Administrator's 
Reference Manual. 

BUGS 

If you try to go at the exact address where a breakpoint is 
set, the breakpoint will not trigger. 

The disassembler works only with protected mode (32 bit) 
instructions. It does not know how to disassemble 16 bit 
instructions. 
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NAME 

kiflall - kill all active processes 

SYNOPSIS 

/etc/killa(l [ signal ] 

DESCRIPTION 

Killall is used by /etc/shutdown to kill all active processes not 
directly related to the shutdown procedure. 

Killall terminates all processes with open files so that the 
mounted file systems will be unbusied and can be unmounted. 

Killall sends signal [see /c///(1)] to all processes not belonging 
to the above group of exclusions. If no signal is specified, a 
default of 9 is used. 

FILES 

/etc/shutdown 

SEE ALSO 

fuser(1M), shutdown(IM). 

kill(1), ps(1) in the User's Reference Manual. 

signal (2) in the Programmer's Reference Manual, 

WARNINGS 

The killall command can be run only by the super-user. 



UP- 13529 



Page 1 



KILLALL(IM) 



[This page left blank.] 



Page 2 



UP-13529 



LABKLIT(IM) 



NAME 

labelit - provide labels for file systems 
SYNOPSIS 

/etc/labelit special [ fsname volume [ -n ] [ -t J ] 
DESCRIPTION 

Labelit can be used to provide labels for unmounted disk file 
systems or file systems being copied to tape. The »n option 
provides for initial labeling only (this destroys previous con- 
tents). The -t option puts tape headers on media other than 
tape. 

With the optional arguments omitted, /abe//f prints current 
label values. 

The special name should be the physical disk section (such as 
/dev/dsk/c0d0s6), or the cartridge tape (for example, 
/dev/rmtO). The device may not be on a remote machine. 

The fsname argument represents the mounted name (for 
example, root, u1, and so forth) of the file system. 

Volume may be used to equate an internal name to a volume 
name applied externally to the disk pack, diskette or tape. 

For file systems on disk, fsname and volume are recorded in 
the superblock. 

SEE ALSO 

sh(1) in the User's Reference Manual. 

fs(4) in the Programmer's Reference Manual, 

WARNINGS 

Labelit applied to a mounted file system will appear to 
succeed, but the next reboot or umount will remove the label. 
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NAME 

/etc/lddrv/lddrv - manage loadable drivers 
SYNOPSIS 

Iddrv [ -m master 1 [ -abdqsuv ] [ devname [ subdevs ] 
] 

Iddrv -a [ v ] [ -k j [ -m master ] [ -o dfile ] devname 
[ subdevs ] 

Iddrv -d [ v ] [ -k ] [ -m master ] devname 
Iddrv -b [ v ] [ -k ] [ -m master ] devname 
Iddrv -u [ v ] [ -k ] [ -m master ] devname 
Iddrv -q [ v ] [ -m master ] devname 
Iddrv -s [ v ] [ -m master ] 
DESCRIPTION 

Lddrv allocates/deallocates space for a specified driver, 
loads/unloads a specified driver, and returns the status of 
specified driver (s). 

The v argument prints verbose information on the screen. 
The -m option allows overriding the default master file 
(/etc/master). The -k flag causes mkdbsym( 1M) to be run 
automatically to update the kernel debugger's symbol table. 
Use -o dfile to specify the name of the file that contains the 
driver's executable code; if omitted, executable code is placed 
in the file devname. The devname argument is the name of 
the driver. 

Devname must correspond to the first field in the master file. 
In addition, the relocatable driver code must be in a file 
named devname .o. More than one major device may be 
plugged with a single invocation of Iddrv by specifying up to 
three subdevices. 

The options are: 

-a Allocate space for and load the driver, 
-d Unload the driver and deallocate its space, 
-b Load (bind) the driver, 
-u Unload the driver. 
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-q Return the status of a particular loadable driver, 
-s Return the status of all loadable drivers. 

EXAMPLES 

A status report for all drivers could look like: 

DEVNAME 10 TYPE BLK CHAR SIZE ADDR FLAGS 

fpe 1 SFTDRV - - 0x5000 OxClOEOOOO ALLOC BOUND 
lp 2 DRIVER - 52 0X7000 0XC121OO0O ALLOC BOUND 

FILES 

/etc/master default master file 

/etc/drvtbl loadable driver table 

/etc/lddrv contains Iddrv and loadable drivers 

/etc/lddrv/unix.sym 

contains kernel symbols 

SEE ALSO 

drvload(IM), mkdbsym(IM), mkifile(IM), nmlmaint(IM), 
drivers(7). 

syslocal(2), master(4) in the Programmer's Reference Manual. 
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NAME 

link, unlink - link and unlink files and directories 

SYNOPSIS 

/etc/link filel file2 

/etc/unlink file 
DESCRIPTION 

The link command Is used to create a file name that points to 
another file. Linked files and directories can be removed by 
the unlink command; however, it is strongly recommended 
that the rm(1) and rmdir [see rm (1)3 commands be used 
instead of the unlink command. 

The only difference between /n(1) and link/unlink is that the 
latter do exactly what they are told to do, abandoning all error 
checking. This is because they directly invoke the link {2) and 
unlink {2) system calls. 

SEE ALSO 

rm(1) in the User's Reference Manual, 

link(2), unlink(2) in the Programmer's Reference Manual. 

WARNINGS 

These commands can be run only by the super-user. 
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NAME 

Ipadmin - configure the LP spooling system 

SYNOPSIS 

Aisr/Hb/lpadmin -pprinter [ options ] 

/usr/lib/lpadmin -xdest 

/usr/iib/lpadmin -d [ dest ] 

DESCRIPTION 

Lpadmin configures line printer (LP) spooling systems to 
describe printers, classes, and devices. It is used to add and 
remove destinations, change membership in classes, change 
devices for printers, change printer interface programs, and 
change the system default destination. Lpadmin may not be 
used when the LP scheduler, /psc/ied(1M), is running, except 
where noted below. 

Exactly one of the -p, -d, or -x options must be present for 
every legal invocation of Ipadmin. 

•pprinter names a printer to which all of the options below 
refer. If printer does not exist then it will be 
created. 

-xdesf removes destination desf from the LP system. If 
dest is a printer and is the only member of a 
class, then the class will be deleted, also. No 
other options are allowed with -x. 

-d[c/esf] makes dest, an existing destination, the new sys- 
tem default destination. If desf is not supplied, 
then there is no system default destination. This 
option may be used when Ipsched (1M) is run- 
ning. No other options are allowed with -d. 

The following options axe only useful with -p and may appear 
in any order. For ease of discussion, the printer will be 
referred to as P below. 

•cclass inserts printer P into the specified class. Class 
will be created if it does not already exist. 

•eprintef copies an existing printer's interface program to 
be the new interface program for P. 

-h indicates that the device associated with P is 

hardwired. This option is assumed when adding 
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a new printer unless the -I option is supplied. 

establishes a new interface program for P. Inter- 
face is the path name of the new program. 

indicates that the device associated with P is a 
login terminal. The LP scheduler, Ipsched, dis- 
ables all login terminals automatically each time it 
is started. Before re-enabling P, its current ctev- 
ice should be established using Ipadmin. 

selects a model interface program for P. Model 
is one of the model Interface names supplied with 
the LP Spooling Utilities (see Models below). 

removes printer P from the specified class. If P 
is the last member of the class, then the class 
will be removed. 

associates a new device with printer P. Device is 
the pathname of a file that is writable by Ip. Note 
that the same device can be associated with 
more than one printer. If only the -p and -v 
options are supplied, then Ipadmin may be used 
while the scheduler is running. 

Restrictions 

When creating a new printer, the -v option and one of the -e, 
-I, or -m options must be supplied. Only one of the -e, -i, or 
-m options may be supplied. The -h and -1 keyletters are 
mutually exclusive, Printer and class names may be no longer 
than 14 characters and must consist entirely of the characters 
A-Z, a-2, 0-9, and _ (underscore). 

Models 

Model printer interface programs are supplied with the LP 
Spooling Utilities. They are shell procedures which interface 
between Ipsched and devices. All models reside in the direc- 
tory /usr/spool/lp/model and may be used as is with Ipadmin 
-m. Copies of model interface programs may also be modi- 
fied and then associated with printers using Ipadmin -I. The 
following describes the models and lists the options which 
may be given on the Ip command line using the -o keyletter 
for each model: 



^interface 
-I 

'mmodel 

-rctass 

-vdevice 
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lqp40 

dpq10 

dumb 

1640 



hp 



prx 
5310 



ethernet 
f450 



Letter quality printer using XON/XOFF protocol at 
9600 baud. 

Dot matrix draft quality printer using XON/XOFF 
protocol at 9600 baud. 

Interface for a line printer without special functions 
and protocol. Form feeds are assumed. This is a 
good model to copy and modify for printers which 
do not have models. 

DIABLO 1640 terminal running at 1200 baud, using 
XON/XOFF protocol. Options: 

•12 12- pitch (10- pitch is the default). 

-f Do not use the 450(1) filter. The output has 
been pre-processed by 450(1). 

Hewlett-Packard 2631A line printer at 2400 baud. 
Options; 

•c Compressed print, 
-e Expanded print. 

Printronix P300 or P600 printer using XON/XOFF 
protocol at 1200 baud. 

AT&T 5310/20 Matrix Printer. Options: 

-f Do not use filter. 

-nc Do not produce cover and trailer sheets. 

-16 or -18 

Set lines per inch accordingly. 

When using this model, set the printer options as 
follows: 



WRAP: YES 
EMUL: ANSI 
LFON: NO 
CRON: NO 
CMOD: NOMD 
PRTY: EVEN 



BAUD: 9600 
FLOW: CHAR 
DC24: NO 
DEOT: NO 
ECHO: NO 
ABAA: NO 



Remote print via Ethernet. 

Interface for DASI 450 terminal, 
passed through the /usr/bin/450 



All output is 
filter or the 
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/usr/lib/etx filter (if processed already by 450 driv- 
ing table or filter). If the filter is not executable, this 
interface disables the Ip printer which it was called 
to service. 

ph. daps Interface to Autologic APS-5 phototypesetter. Out- 
put is passed through filter daps, which is also a 
command. 

pprx Interface for printronix line printer with parallel 
interface. All output is passed through the 
/usr/libfpprx filter. If the filter is not executable, 
this interface disables the Ip printer which it was 
called to service. 

serial Serial line printer. This interface is identical to the 
dumb model, except that it issues an stty command 
that sets the following serial port characteristics: 8 
bits, no parity, 9600 baud, XON/XOFF, pass tabs 
through to printer. 

EXAMPLES 

An Iqp40 printer called pri can be added to the ip configura- 
tion with the command: 

/usr/lib/lpadroin -ppr1 - v/dev/contty -mlqpio 

Assuming there is an existing Hewlett-Packard 2631 line 
printer named hp2, it will use the hp model interface after the 
command: 

/usr/l ib/lpadmfn -php2 -mhp 
To obtain compressed print on /ip2, use the command: 
Ip -dhp2 -o-c files 

FILES 

/usr/spool/lp/* 

SEE ALSO 

accept(1M), lpsched(1M). 

enable(1), lp(1), lpstat(1) in the User's Reference Manual. 
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NAME 

Ipsched, Ipshut, ipmove - start/stop the LP scheduler and 
move requests 

SYNOPSIS 

/usr/Iib/lpsched 

/usr/lib/lpshut 

/usr/lib/Ipmove requests dest 
/usr/Hb/lpmove destl dest2 
DESCRIPTION 

Lpsched schedules requests taken by /p(1) for printing on line 
printers (LP's). 

Lpshut shuts down the line printer scheduler. All printers that 
are printing at the time Ipshut is invoked will stop printing. 
Requests that were printing at the time a printer was shut 
down will be reprinted in their entirety after Ipsched is started 
again. All LP commands perform their functions even when 
Ipsched is not running. 

Lpmove moves requests that were queued by /p(1) between 
LP destinations. This command may be used only when 
Ipsched is not running. 

The first form of the command moves the named requests to 
the LP destination, dest. Requests are request IDs as 
returned by /p(1). The second form moves ail requests for 
destination destl to destination dest2. As a side effect, Ip (1) 
will reject requests for destl. 

Note that Ipmove never checks the acceptance status [see 
accept (1M)j for the new destination when moving requests. 

FILES 

/usr/spool/lp/* 

/etc/rc2.d/SXXlp initialization for Ip or Ipr spooling system 

SEE ALSO 

accept(1M), lpadmin(1M). 

enable(1), )p(1), lpstat{1) in the User's Reference Manual. 
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NAME 

Ipset - set parallel line printer options 
SYNOPSIS 

Ipset [ -1 indent ] [ -c columns ] [ -I lines ] 
DESCRIPTION 

Lpsef sets the translation options for the parallel printer inter- 
face. The options set the indent (-i), number of columns (-c), 
and lines per page (-1); the interpretation of these options by 
the interface is described under lp(7). 

With no options, Ipset reports the current values. Initially, the 
values are: an indent of 4, 132 columns, 66 lines per page. 

FILES 

/dev/lp? 

/etc/rc2.d/SXXIp initialization for Ip or Ipr spooling system 

SEE ALSO 

lp(7). 
DIAGNOSTICS 

Self explanatory, except that "parallel printer not properly con- 
nected" may actually mean that the printer is in use. 
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NAME 

masterupd - update the master file 

SYNOPSIS 

masterupd [ flags ] [ devicename J 

DESCRIPTION 

Masterupd is used to manipulate the /etc/master file. 
Although the file can be directly edited, it is often more con- 
venient to use the features of masterupd. The flags are: 

-a Add a device to the master file. The devicename must be 
specified. Also, the -f flag must be given to specify the 
device's functions. 

•d Delete a device from the master file. Only the de- 
vicename need be given. If the device is not found in the 
master file, the command silently terminates with no error 
message. 

-q Query the master file for a particular device. The de- 
vicename must be given. Also, one of the device type 
flags (see below) must be given to specify what type of 
device to look for. If a block or character device is speci- 
fied, the major number is written to standard output. If a 
line discipline is specified, the line discipline index is out- 
put. If a software module is specified, the software ID is 
output. If the device cannot be found in the master file, a 
question mark is output. 

•v Verify the consistency of the master file. 

Any or all of the above flags may be used together. If -a is 
used with -d, the device is deleted from the master file first, 
then added again. If the «q option is used with -a and/or -d, it 
reports the major number of the device after the 
addition/deletion. 

The -a flag and the -q flag require a device type to be given. 
The following flags specify the device type: 

-b block device 

-c character device 

-I line discipline 

-m stream module 
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-s software module 
-r required device 

Other flags that may be used with -a are: 

-f followed by a string of function letters, specifies functions 
for the device. See master{4) for a description of the 
letters. 

-p followed by a string, specifies a prefix for the device. 
Default is the device name. 

■I followed by a decimal integer, specifies an init parameter 
for the device. Up to three -i flags may be given to 
specify up to three init parameters which are appended to 
the end of the line in the master file. 

The -M flag may be used to specify an alternate master file. 

EXAMPLES 

To install a new character device driver named "xyz" (with the 
prefix "xyz") and functions open, close, read, write, ioctl, init, 
and release: 

master upd -a -c -f ocrwf xyz 

As a more realistic example, the following script does the 
same, but first deletes the driver if it already in the master file 
and uses the query feature to make /dev files for the newly 
assigned character major number: 

MAJ=' master upd -daq ~c -f ocrwi xyz* 

if [ "SMAJ" = "?" ] 

then 

echo "Error" 
else 

mknod /dev/xyzO c SMAJ 0 
mknod /dev/xyz1 c SMAJ 1 

• » * 

fi 

SEE ALSO 

config(1M). 

master (4) in the Programmer's Reference Manual. 
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NAME 

mkdbcmd - load commands into the kernel debuggerq 
DESCRIPTION 

The 6000/50 Debug Monitor is a simple monitor that resides in 
the System V kernel and allows the programmer to examine 
and modify memory, disassemble instructions, download and 
execute programs, set breakpoints, and single-step instruc- 
tions. 

After loading the debug monitor with /o*o7v(1M), the monitor is 
entered by typing control-B on the console [see cons (1M)]. 

Commands 

All monitor commands are two characters, followed by zero or 
more arguments. In the following descriptions, optional argu- 
ments are enclosed in square brackets. Arguments are 
separated by spaces or commas, and each argument must be 
one of the following: 

1. A hex number. 

2. A percent sign followed by a register name, meaning the 
contents of that register, such as %eax, %esp, %eflags. 
Only 32-bit registers are allowed; 8- or 16-bit registers are 
invalid. 

A percent sign followed by a breakpoint number, meaning the 
address referred to by the that breakpoint, such as %bx. 

3. A dollar sign, meaning the address of the last memory 
location that was displayed. 

4. The name of a kernel symbol. This works only if the ker- 
nel debugger has been loaded with the System V symbol 
table via the mkdbsym (1M) command. 

5. Any of the above combined by using the usual arithmetic 
operators (+-*/% & J ") or the relational operators 
used as used in the C programming language {== ! = 
<> <= >=). All operators have equal precedence. 
Use parentheses to force a particular order of evaluation. 

Input Commands 

The debug monitor prompts with K>. This prompt indicates 
the monitor is ready to accept any of the commands 
described below. Input characters can be erased with BACK- 
SPACE or DEL. An entire input line can be erased with 
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control-U or control-X. 

After a breakpoint or debug trap, the monitor prints a status 
line describing the trap, immediately followed by the K 
prompt, and is again ready to accept commands. In the case 
of a trace trap, the monitor automatically supplies the 
expected command, tr. If you want to enter a different com- 
mand, erase the tr and retype a new command. 

During any of the display, modify, examine or write com- 
mands, you can enter one of the following: 

RETURN 

Moves to the next item. 

+n Moves to the nth next item. 

Moves to the previous item. 

-n Moves to the nth previous item. 

=addr 

Moves to the item at address addr. Only valid when 
operating on memory, not on registers. 

n Changes the value of the item to n. Only valid for modify 
or write commands, not display or examine. The mi com- 
mand allows you to enter multiple numbers separated by 
spaces, to change more than one byte. 

q (Or any character other than + - « or a hex number). 
Exits the command and returns to the monitor prompt. 

Display Commands 

These commands allow you to examine memory only. This 
prevents accidental modification of system memory when in 
the debug monitor. 

dl addr [ count ] 

Displays memory as longs (4 byte hex integers), 32 bytes 
at a time. If a count is given, memory is displayed 32 * 
count bytes at a time. 
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dw addr [ count ] 

Displays memory as words (2 byte hex integers), 32 bytes 
at a time. 

db addr [ count ] 

Displays memory as bytes (1 byte hex integers), 32 bytes 
at a time. 

dl [ addr ] 

Displays memory as disassembled instructions. The 
default addr is the contents of %eip. 

dr Displays the CPU general registers. 

dR Displays the CPU "special" registers (debug, control, and 
table base registers). 

dy addr [ count ] 

Similar to dl, but displays the longs in symbolic form, if 
possible. 

se sfarf end pattern [ mask ] 

Searches for the given pattern in the range of addresses 
starting at start, up to (but not including) end. The 
search is performed on longs. If a mask is given, only 
those bits corresponding to 1 bits in the mask are signifi- 
cant in the search. 

Examine Commands 
el addr 

Examines memory as longs, one at a time, 
ew addr 

Examines memory as words, one at a time. ' 
eb addr 

Examines memory as bytes, one at a time, 
ei [ addr ] 

Examines memory as disassembled instructions. (Same 
as di.) 

er Examines CPU general registers, one at a time. 
eR Examines the CPU special registers, one at a time. 

Modify Commands 

ml addr 

Examines and optionally modifies memory, as longs. 
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mw addr 

Examines and optionally modifies memory, as words, 
mb addr 

Examines and optionally modifies memory, as bytes, 
mi [ addr ) 

Examines memory as instructions and optionally modifies 
(as bytes). 

mr Examines and optionally modifies the CPU registers. 

mR Examines and optionally modifies the CPU special regis- 
ters. 

Write Commands 
wl addr 

Writes memory as longs, without examining, 
ww addr 

Writes memory as words, without examining, 
wb addr 

Writes memory as bytes, without examining. 

I/O Commands 

in addr 

Reads a byte from the specified I/O port, 
iw addr 

Reads a word (2 bytes) from the specified I/O port, 
it addr 

Reads a longword (4 bytes) from the specified I/O port. 

ou addr value 

Outputs a byte {value) to the specified I/O port. 

ow addr value 

Outputs a word {value) to the specified I/O port. 

ol addr value 

Outputs a longword {value) to the specified I/O port. 

Execute Commands 
go [ addr ] 

Starts execution. 

tr [ addr ] 

Trace: single step one instruction. 
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to [ addr ] 

Trace over: single step over "call" instructions. 
Breakpoint Commands 

A breakpoint invokes the debug monitor just prior to the exe- 
cution of a specified instruction. There are a total of sixteen 
instruction breakpoints available. 

br [ addr ] 

Sets a breakpoint. The default address is the contents of 
%eip. 

be [ addr ] 

Clears (removes) a breakpoint. 

bC [ado*/*] 

Clears (removes) all breakpoints. 

bx[addr] 

Sets a temporary (one-shot) breakpoint. 

bo [ addr ] 

Turns a breakpoint on or off. If a breakpoint is turned off, 
it acts as though it were cleared, but the breakpoint 
remains in the breakpoint table. 

bp Displays breakpoints. 

Memory Breakpoint Commands 

A memory breakpoint invokes the debug monitor when a 
specified memory location is referenced. There are a total of 
four memory breakpoints available. 

ur num type [ addr ] 

Sets a memory breakpoint. Num must be 0 to 3, addr is 
the breakpoint address, and type gives the type of 
memory access that will trigger the breakpoint. Valid 
types are: 

0 Execute 

10 Byte write 

1 1 Byte read/write 

20 Word write 

21 Word read/write 

40 Long write 

41 Long read/write 
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Note that the first digit specifies the breakpoint length 
and the second specifies the access type (write-only or 
read/write). The breakpoint is global unless the type is 
ORed with 100, which makes it local; or with 200, which 
makes it global and local. For example, 140 specifies a 
local long write-only breakpoint. 

ux num type [ addr ) 

Like ur, but sets a temporary (one-shot) breakpoint. 

uc num 

Clears a memory breakpoint. 

up Prints all memory breakpoints. 

Miscellaneous Commands 
bt [ addr ] 

Displays a stack backtrace, using addr as a frame pointer. 
The default address is the contents of %ebp. This works 
only with C language routines in protected mode. 

fi sfart end value 

Fills memory from address start up to (but not including) 
address end with the byte value. 

pg "string" [ args... ] 

Prints the string. Percent signs in the string are treated 
as in printf{3S): %d, %u, %x, %o, %b, %s, %s, %c are 
supported. 

In addition, %y prints its argument in symbolic form, if possi- 
ble. 

rc Reads any commands that have been loaded previously 
with the mkdbcmd (1 M) command. 

rg [ addr ] 

Changes the pointer to the "register save area," from 
which all references to CPU registers, such as the dr com- 
mand, and explicit reference, such as %ebx, or an implicit 
reference, such as the di command with no argument, 
retrieve registers. Normally, the register save .area is set 
up automatically, but you can use a different set of regis- 
ters when you use rg to change the pointer. 

P9 [n] 

If n is 0, turns paging off. If n is 1, turns paging on. If n 
is missing, it simply reports whether paging is on or off. If 
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paging is off, the monitor interprets all addresses as phy- 
sical addresses. If paging is on, addresses are inter- 
preted as linear (virtual) addresses, (Breakpoints are 
always linear addresses.) 

ma addr 

Displays the page directory and page table entries used 
to map the given linear address to a physical address. 
This behaves the same whether paging is on or off. 

c3 addr 

Uses the given physical address as the base of the page 
directory for translating linear to physical addresses. This 
address is obtained from the special register CR3 if no c3 
command is given. 

pr addr 

Prints the value of the address given as an argument. 
This is most useful if addr is an expression (see the earlier 
discussion of arguments). 

ds addr 

Prints the value of the address as an offset from the 
nearest symbol. 

sy [ n ] [ max ] 

If n is 0, turns symbolic display off. If n is 1 , turns sym- 
bolic display on. If n is missing, it simply reports whether 
symbolic display is on or off. If max is given, it specifies 
the maximum offset for printing symbols. For example, if 
max is 1000, a symbol may be displayed in the form 
name+NNN, where NNN is 1 through 1000, but if NNN 
would be greater than 1000, the non-symbolic display for- 
mat is used. 

he or ?? 

Lists the monitor commands. 

ve Prints the version number of the monitor. 

Macro Commands 

dm "name" arg-count 

Defines a MACRO, with the given name and the specified 
number of arguments. The cm command (described 
below) can be used subsequently to invoke the macro. 
After you enter the dm command, the debugger prompts 
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with mao for the body of the macro. Any debugger 
commands can be entered as the body of the macro, 
although interactive commands, such as di are not recom- 
mended. The expression $n, where n is a digit from 1 to 
9, is replaced on invocation with the nth argument to the 
macro. Entry of the macro body is terminated by a period 
{.) anywhere in the macro body. Include a period in the 
macro body by preceding the character with a backslash 
V. 

cm "name" args 

Calls a macro. The number of arguments must match the 
number given when the macro was defined. The effect is 
as if the body of the macro were entered in place of the 
cm command. 

em "name" 

Erases (deletes) the named macro. 

im ["name"] 

Lists the named macro. If the macro name is omitted, 
lists all macros. 

nx Repeats the call to the previously invoked macro. The 
arguments used ar the ones used on the previous call, 
possibly modified by any intervening sa commands. 

sa n value 

Sets the nth macro argument to the given value. The 
value of n should be between 1 and 9. Useful within a 
macro to set up the arguments for the next call through 
an nx commmand. 

ec [n] 

If n is 1, macros are echoed when they are invoked. If n 
is 0 (the default), macros are not echoed. If n is missing, 
the status of the echo flag is printed. If the ec command 
is given within a macro body, it is in effect only for that 
macro. 

Conditional Commands 
IF expr EL FI 

If the expression evaluates to zero, all commands up to 
the matching EL or FI are skipped. If the expression is 
non-zero, execution proceeds normally to the matching 
FI, unless a matching EL is found, in which case, 
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commands between the EL and the FI are skipped. Dur- 
ing any of this "skipping," the prompt changes from K> 
to \mK> to Indicate that the commands are being read 
but not executed. 

SEE ALSO 

cons(1M), Iddrv(lM), mkdbsym(IM) in the Administrator's 
Reference Manual, 

BUGS 

If you try to go at the exact address where a breakpoint is 
set, the breakpoint will not trigger. 

The disassembler works only with protected mode (32 bit) 
instructions. It does not know how to disassemble 16 bit 
instructions. 
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NAME 

mkdbsym - add symbols to kernel debugger 

SYNOPSIS 

mkdbsym [ -s ] [ -u ] [ -d ] [ symfile ] 

DESCRIPTION 

Mkdbsym allows the kernel debugger to use symbolic names 
in addition to numeric addresses. The symbols are taken from 
the named symfile, or /unix if symfile is not specified. 

There are three options to mkdbsym: 

-s By default, if the symbol file appears not to match the 
running kernel, mkdbsym prints an error message and 
exits. The -s flag overrides this check. 

•u Specifies an update: the symbols from symfile are 
appended to any symbols which are currently known to 
the debugger. This is useful, for example, in adding sym- 
bols for a newly loaded loadable driver [see lddrv(lM)]. 

-d Causes the symbols in the symbol file to be deleted from 
the kernel debugger, If any symbol in the symbol file is 
not currently in the kernel debugger, a warning message 
is printed. 

FILES 

/etc/lddrv/unix.sym contains kernel symbols 

SEE ALSO 

lddrv{1M). 

kdb(1) in the Programmer's Reference Manual, 
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NAME 

mkfs - construct a file system 

SYNOPSIS 

/etc/mkfs [ -y ] special [ -O J [ blocks ] 
[ :i-nodes ] [ gap blocks/cyl } 

/etc/mkfs [ -y ] special [ -O ] proto [ gap blocks/cyl ] 
DESCRIPTION 

Mkfs constructs a file system by writing on the special file 
using the values found in the remaining arguments of the 
command line. The command asks for confirmation before 
starting to construct the file system, unless the -y flag is given. 

If the second argument is a string of digits, the size of the file 
system is the value of blocks interpreted as a decimal number. 
This is the number of 1K byte disk blocks the file system will 
occupy. If the second argument is missing, the size of the file 
system is taken to be the size of the partition, determined by 
reading the volume home block of the disk [see /V(1}]. If the 
number of i-nodes is not given, the default is the number of 
logical (1024 byte) blocks divided by 4. Mkfs builds a file sys- 
tem with a single empty directory on it. The boot program 
block (block zero) is left uninitialized. 

The -O option makes a file system with a free list instead of a 
bit map 

If the second argument is the name of a file that can be 
opened, mkfs assumes it to be a prototype file proto, and will 
take its directions from that file. The prototype file contains 
tokens separated by spaces or new-lines. A sample prototype 
specification follows (line numbers have been added to aid in 
the explanation): 



1. 


/stand/ dtskboot 


2. 


4872 no 




3. 


d--777 3 1 




4. 


usr d- - 777 


3 1 


5. 


sh 


---755 3 1 /bin/sh 


6. 


:!_ rsh 


/bin/sh 


7. 


ken 


d- - 755 6 1 


8. 




$ 


9. 


bO 


b--6*Mi 3 10 0 


10. 


CO 


C--64U 1 0 0 
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11. $ 

12. $ 

Line 1 in the example is the name of a file to be copied onto 
biock zero as the bootstrap program. 

Line 2 specifies the number of 1K byte blocks the file system 
is to occupy and the number of i-nodes in the file system. 

Lines 3-10 tell mkfs about files and directories to be included 
in this file system. 

Line 3 specifies the root directory. 

Line 6 tells mkfs to link rsh to /bin/sh. 

Lines 4-7 and 9-10 specify other directories and files. 

The $ on line 8 tells mkfs to end the branch of the file system 
it is on, and continue from the next higher directory. The $ on 
lines 11 and 12 end the process, since no additional specifica- 
tions follow. 

File specifications give the mode, the user ID, the group ID, 
and the initial contents of the file, Valid syntax for the con- 
tents field depends on the first character of the mode. 

The mode for a file is specified by a 6-character string. The 
first character specifies the type of the file. The character 
range is -bed to specify regular, block special, character spe- 
cial, and directory files respectively. The second character of 
the mode is either u or - to specify set-user-id mode or not. 
The third is g or - for the set-group-id mode. The rest of the 
mode is a 3 digit octal number giving the owner, group, and 
other read, write, execute permissions [see chmod(\)]. 

Two decimal number tokens come after the mode; they 
specify the user and group IDs of the owner of the file. 

If the file is a regular file, the next token of the specification 
may be a path name whence the contents and size are 
copied. If the file is a block or character special file, two 
decimal numbers follow which give the major and minor dev- 
ice numbers. If the file is a directory, mkfs makes the entries . 
and .. and then reads a list of names and (recursively) file 
specifications for the entries in the directory. As noted above, 
the scan is terminated with the token $. 
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The final argument in both forms of the command specifies 
the rotational gap and the number of blocks/cyl. 

If the gap and blocks/cyl are not specified or are considered 
illegal values a default value of gap size 7 and 400 blocks/cyl 
is used. 

FILES 

/usr/lib/iv 

SEE ALSO 

chmod(1) in the User's Reference Manual. 

dir(4), fs{4) in the Programmer's Reference Manual. 

BUGS 

With a prototype file, it is not possible to copy in a file larger 
than 64K bytes. The maximum number of i-nodes configur- 
able is 65500. The :L syntax in the prototype file is not sup- 
ported in this release. 
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NAME 

mkifile - make an ifile from an object file 

SYNOPSIS 

mkifile a.out ifile 

DESCRIPTION 

Mkifile takes an object module and writes in ifile a line of the 
form 

symbol = Qxvalue] 

for each external symbol in the object module. This ifile can 
be used as an argument to ld(1) as an absolute symbol table 
against which other modules may be linked. Mkifile is used 
with loadable drivers to provide the symbols for the currently 
running System V. 

For example, 

mkifile /unix /etc/1 ddrv/unix.sym 
will produce the unix/sym file needed by Iddrv. 

SEE ALSO 

ld(1), Iddrv(lM). 
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NAME 

mklost + found - make a lost + found directory for fsck 

SYNOPSIS 

/etc/mklost + found 

DESCRIPTION 

A directory lost + found is created in the current directory and 
a number of empty files are created therein and then removed 
so that there will be empty slots for f$ck(M). This command 
should be run immediately after first mounting a newly 
created file system. 

SEE ALSO 

fsck(lM),mkfs(1M) 

BUGS 

Should be done automatically by mkfs . 
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NAME 

mknod - build special file 

SYNOPSIS 

/etc/mknod name b { c major minor 

/etc/mknod name p 

DESCRIPTION 

Mknod makes a directory entry and corresponding i-node for 
a special file. 

The first argument is the name of the entry. The 6000/50 Sys- 
tem convention is to keep such files in the /dev directory. 

In the first case, the second argument is b if the special file is 
block-type (disks, tape) or c if it is character-type (other dev- 
ices). The last two arguments are numbers specifying the 
major device type and the minor device (for example, unit, 
drive, or line number). They may be either decimal or octal. 
The assignment of major device numbers is specific to each 
system. The information is contained in the system source file 
conf.c. You must be the super-user to use this form of the 
command. 

The second case is the form of the mknod that is used to 
create fifo's (also called named pipes). 

WARNING 

If mknod is used to create a device in a remote directory 
(Remote File Sharing), the major and minor device numbers 
are interpreted by the server. 

SEE ALSO 

mknod (2) in the Programmer's Reference Manual . 
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NAME 

mount, umount - mount and unmount file systems and remote 
resources 

SYNOPSIS 

/etc/mount [ [ *r ] [ -f fstyp ] special directory ] 
/etc/mount [ [ -r ] [ -d ] resource directory ] 
/etc/umount special 
/etc/umount [ -d ] resource 
DESCRIPTION 

File systems other than root (/) are considered removable in 
the sense that they can be either available to users or unavail- 
able. Mount announces to the system that special, a block 
special device, or resource, a remote resource, is available to 
users from the mount point directory. Directory must exist 
already; it becomes the name of the root of the newly 
mounted special. 

Mount, when entered with arguments, adds an entry to the 
table of mounted devices, /etc/mnttab. Umount removes the 
entry. If invoked with no arguments, mount prints the entire 
mount table. If invoked with an incomplete argument list, 
mount searches /etc/fstab for the missing arguments. 

The following options are available: 

-r Indicates that special or resource is to be mounted 

read-only. If special or resource is write-protected, 
this flag must be used. 

-d Indicates that resource is a remote resource that is 

to be mounted on directory or unmounted. To 
mount a remote resource, Remote File Sharing 
must be up and running and the resource must be 
advertised by a remote computer [see rfstart{1hA) 
and aoV(1M)j. If -d is not used, special must be a 
local block special device. 
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-f fstyp Indicates that fstyp is the file system type to be 
mounted. If this argument is omitted, it defaults to 
the root fstyp. 

special Indicates the block special device that is to be 
mounted on directory. 

resource indicates the remote resource name that is to be 
mounted on a directory. 

directory indicates the directory mount point for special or 
resource, (The directory must already exist.) 

Umount announces to the system that the file system previ- 
ously mounted special or resource is to be made unavailable. 
If invoked with an incomplete argument list, umount searches 
/etc/fstab for the missing arguments. 

Mount can be used by any user to list mounted file systems 
and resources. Only a super-user can mount and unmount 
file systems. 

FILES 

/etc/mnttab mount table 
/etc/fstab file system table 

SEE ALSO 

adv(1M), fuser(1M), rfstart(IM), setmnt(lM), unadv(1M). 
mount (2), umount (2), f stab (4), mnttab(4) in the Programmer's 
Reference Manual. 

DIAGNOSTICS 

If the mount {2) system call fails, mount prints an appropriate 
diagnostic, mount issues a warning if the file system to be 
mounted is currently mounted under another name. A remote 
resource mount will fail if the resource is not available or if 
Remote File Sharing is not running, 

Umount fails if special or resource is not mounted or if it is 
busy, Special or resource is busy if it contains an open file or 
some user's working directory. In such a case, you can use 
fuser(1M) to list and kill processes that are using special or 
resource. 

WARNINGS 

Physically removing a mounted file system diskette from the 
diskette drive before issuing the umount command damages 
the file system. 
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NAME 

mountait, umountall - mount, unmount multiple file systems 

SYNOPSIS 

/etc/mountall [ - ] [ file-system-table ] ... 

/etc/umountall [ -k ] 

DESCRIPTION 

These commands may be executed only by the super-user, 

Mountall is used to mount file systems according to a file- 
system-table, (/etc/fstab is the default file system table.) The 
special file name reads from the standard input. 

Before each file system is mounted, it is checked using 
fsstat (1M) to see if it appears mountable. If the file system 
does not appear mountable, it is checked, using feck{1M), 
before the mount is attempted. 

Umountall causes all mounted file systems except root to be 
unmounted. The -k option sends a SIGKILL signal, via 
fuser (1M), to processes that have files open. 

The file-system-table has the following format: 

column 1 block special file name of file system 

column 2 mount-point directory 

column 3 -r if to be mounted read-only; -d if remote 

column 4 (optional) file system type string 

column 5+ ignored 

White-space separates columns. Lines beginning with "#" are 
comments. Empty lines are ignored. 

A typical file-system-table might read: 
/dev/dsk/dd1s3 /usr -r S51K 

SEE ALSO 

fsck(1M), fsstat(1M), fuser(1M), mount(lM). 

signal (2), f stab (4) in the Programmer's Reference Manual, 

DIAGNOSTICS 

No messages are printed if the file systems are mountable 
and clean. 
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Error and warning messages come from fsck(1M), fssfaf{1M), 
and mount (1M). 
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NAME 

mvdir - move a directory 

SYNOPSIS 

/etc/mvdir dirname name 

DESCRIPTION 

Mvdir moves directories within a file system. Dirname must be 
a directory. If name does not exist, it will be created as a 
directory. If name does exist, dirname will be created as 
name/dirname. Dirname and name may not be on the same 
path; that is, one may not be subordinate to the other. For 
example: 

ravcU r x/y x/z 
is legal, but 

mvdir x/y x/y/z 
is not. 
SEE ALSO 

mkdir(1), mv(1) in the User's Reference Manual. 

WARNINGS 

Only the super-user can use mvdir. 
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NAME 

ncheck - generate path names from i-numbers 
SYNOPSIS 

/etc/ncheck [ -I i-numbers ] [ -a ] [ -s ] [ file-system ] 
DESCRIPTION 

Ncheck with no arguments generates a path- name versus i- 
number list of all files on a set of default file systems (see 
/etc/checklist). Names of directory files are followed by /.. 

The options are as follows: 

-1 Limits the report to only those files whose i-numbers fol- 
low. 

-a Allows printing of the names . and .., which are ordinarily 
suppressed. 

-s Limits the report to special files and files with set- user-ID 
mode. This option may be used to detect violations of 
security policy. 

A file system may be specified by its special file. 

The report should be sorted so that it is more useful. 

SEE ALSO 

fsck(1M). 

sort(1) in the User's Reference Manual. 
DIAGNOSTICS 

If the file system structure is not consistent, ?? denotes the 
"parent" of a parentless file and a path-name beginning with 
. . . denotes a loop. 
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NAME 

newgrp - log in to a new group 

SYNOPSIS 

newgrp [ - ] [ group ] 

DESCRIPTION 

Newgrp changes a user's group identification. The user 
remains logged in and the current directory is unchanged, but 
calculations of access permissions to files are performed with 
respect to the new real and effective group IDs, The user is 
always given a new shell, replacing the current shell, by 
newgrp, regardless of whether it terminated successfully or 
due to an error condition (that is to say, unknown group). 

Exported variables retain their values after invoking newgrp', 
however, all unexported variables are either reset to their 
default value or set to null. System variables {such as PS1, 
PS2, PATH, MAIL, and HOME), unless exported by the sys- 
tem or explicitly exported by the user, are reset to default 
values. For example, a user has a primary prompt string 
(PS1) other than $ (default) and has not exported PS1. After 
an invocation of newgrp, successful or not, their PS1 will now 
be set to the default prompt string $. Note that the shell com- 
mand export [see sh[\)] is the method to export variables so 
that they retain their assigned value when invoking new shells. 

With no arguments, newgrp changes the group identification 
back to the group specified in the user's password file entry. 
This is a way to exit the effect of an earlier newgrp command. 

If the first argument to newgrp is a the environment is 
changed to what would be expected if the user actually 
logged in again as a member of the new group. 

A password is demanded if the group has a password and the 
user does not, or if the group has a password and the user is 
not listed in /etc/group as being a member of that group. 
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FILES 

/etc/group system's group file 

/etc/passwd system's password file 

SEE ALSO 

csh(1), iogin(1),sh{1). 

group(4), passwd(4), environ(5) in the Programmer's Refer- 
ence Manual. 

BUGS 

There is no convenient way to enter a password into 
/etc/group. Use of group passwords is not encouraged, 
because, by their very nature, they encourage poor security 
practices. Group passwords may disappear in the future. 
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NAME 

nlsadmin - network listener service administration 

SYNOPSIS 
nlsadmin -x 

nlsadmin [ options ] net_spec 
DESCRIPTION 

Nlsadmin administers the network listener process(es) on a 
machine. Each network has a separate instance of the net- 
work listener process associated with it; each instance (and 
thus, each network) is configured separately. The listener pro- 
cess "listens" to the network for service requests, accepts 
requests when they arrive, and spawns servers in response to 
those service requests. The network listener process will work 
with any network (more precisely, with any transport provider) 
that conforms to the transport provider specification. 

The listener supports two classes of service: a General 
Listener Service that starts server daemons with connections 
for clients on remote machines, and a Terminal Login Service 
that starts a getty (1M) process for login clients on remote 
machines. The Terminal Login Service requires special associ- 
ated software, and is only available with some networks. 
Currently, it is supported on the AT&T STARLAN and the 
DARPA Internet networks. 

The following may be given as option parameters or argu- 
ments to nlsadmin; 

netjspec The relative pathname under /dev of the network 
special device (that is to say, the STREAMS driver) 
to open for access to a given network. 

Note that the example below, and other Internet- 
specific examples and files that follow, would 
operate as described only if optional Internet 
drivers and utilities were installed on the 6000/50 
system. 



UP-13529 



Page 1 



NLSAI)MIN(IM) 



For example, inet/tcp refers to the Transmission 
Control Protocol (fcp) transport provider within the 
DARPA Internet {inet) protocol family. 

service Uniquely identifies the service the listener is manag- 
ing. It may be expressed symbolically as a name 
or numerically as a code. If a name is given, it is 
looked up in the file /usr/net/nls/servcodes [see 
sen/codes (4)3 and converted into a code. 

address The transport address on which the listener awaits 
requests for service. Since they await disjointed 
sets of services, the General Listener Service and 
the Terminal Login Service require separate listener 
network addresses, network addresses are inter- 
preted using a syntax that allows for a variety of 
addressing formats [see reso/vers(5)]. For exam- 
ple, the two listener addresses on host spcfast 
serving a DARPA Internet network could be 
expressed symbolically as: 

\ : inet : nlsgen : spefast . Convergent . COM 

\ : inet : ntsterm : spefast . Convergent . COM 

The "\:" sequence determines the syntax of the 
remainder of the address, symbolic in this case. 
The transport provider is in the inet protocol and 
addressing family. Thus, the inet program in direc- 
tory /usr/net/resolvers is executed with the com- 
plete address as an argument in order to fully 
resolve the symbolic network address. It converts 
either nlsgen or nisterm via the /etc/services into 
the service "port" and then converts 
spcfast.Convergent.COM via /etc/hosts into the 
network "host" address. A fully resolved network 
address suitable for an Internet transport provider 
is returned via the standard output. 

Each unique network (that is to say, net_spec) must have a 
dedicated listener process. When the network is first con- 
nected, nisadmin with the -I option must be used to initialize 
the listener's database, the -I and -t options used to set the 
listener's addresses, and the -a option used to explicitly add 
supported services. Once the networks on a new machine 
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have been set up, they do not need to be set up again. If a 
unique new network (that is to say, netjspec) is connected, 
then these steps should be repeated. 

Once the network is set up, nlsadmin can be used to query 
the status of all or particular listener networks and services, 
start or kill the listener process per network, temporarily 
enable or disable a service per network, or permanently add 
or remove a service per network. Changing the list of services 
provided by the listener produces immediate changes, while 
changing an address on which the listener listens has no 
effect until the listener is restarted. 

The following combinations of options can be used. 

nlsadmin Gives a brief usage message. 

nlsadmin -x 

Reports the status of all of the listener processes 
installed on this machine. 

nlsadmin netjspec 

Prints the status of the listener process for 
netjspec, 

nlsadmin -q netjspec 

Queries the status of the listener process for the 
specified network, and reflects the result of that 
query in its exit code. If a listener process is active, 
nlsadmin exits with a status of 0; if no process is 
active, the exit code is 1; while the exit code is 
greater than 1 in case of error. 

nlsadmin -v netjspec 

Prints a verbose report on the servers associated 
with netjspec, giving the service code, status, com- 
mand, and comment for each. 

nlsadmin -z service netjspec 

Prints a report on the server associated with 
netjspec that has service name or code service, 
giving the same information as in the -v option. 

nlsadmin -q -z service net_spec 

Queries the status of the service with service name 
or code service on network netjspec, and exits 
with a status of 0 if that service is enabled, 1 if that 
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service is disabled, and greater than 1 in case of 
error. 

nlsadmin -I address netjspec 

Changes or sets the address on which the General 
Listener Service listens for network netjspec. This 
is the address generally used by remote processes 
to access the servers available through this listener 
(see the -a option, below). 

A change of address will not take effect until the 
next time the listener for that network is started. 
Since ail listeners on a common network must be 
reachable by remote clients at a commonly agreed 
address, care should be exercised when changing 
the listener address. For the Internet networks, this 
"known" address is built from the service "port" in 
the shared /etc/services file. 

If address is just a dash ("-"), nlsadmin reports the 
address currently configured, instead of changing 
it. 

nlsadmin -t address netjspec 

Changes or sets the address on which the Terminal 
Login Service listens for network nef_spec. A ter- 
minal service address should not be defined unless 
the appropriate remote login software is available. 
Otherwise, this option is identical to the -I option. 
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nlsadmin -i netjspec 

Initializes or changes a listener process for the net- 
work specified by netjspec, that is, it creates and 
initializes the files required by the listener. Note 
that the listener should only be initialized once for a 
given network, and that doing so does not actually 
invoke the listener for that network. The listener 
must be initialized before assigning addressing or 
services. 

nlsadmin [-m] -a service [-c command] [-p modules] 

[-y comment] netjspec 

Adds a new service to the list of services available 
through the General Listener Service for network 
netjspec. When a service is added, it is automati- 
cally enabled (see the -e and -d options, below). If 
the -m option is specified, the entry is added but 
not emabled: it is marked as an administrative 
entry. 

The command is the full pathname of the command 
with all arguments that are to be invoked in 
response to the service request. Since it must 
appear as a single word to the shell, it should be 
quoted if arguments are given. If the -c option is 
not given, then the service is looked up in 
/usr/net/nls/servcodes where the command and 
arguments must be found. 

If the -p option is specified, then modules is inter- 
preted as a list of STREAMS modules for the 
listener to push before starting the added service. 
The modules are pushed in the order they are 
specified. The module list is specific to the network 
(netjspec) supporting the service. 

The optional comment is a brief (free-form) descrip- 
tion of the service for use in various reports. If the 
comment contains white space, it must be quoted. 
If the comment is not specified, then the service is 
looked up in /usr/net/nls/servcodes where the 
default comment may be found. 

nlsadmin -r service netjspec 

Removes the entry for the service from that 
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listener's list of services. This is normally per- 
formed only in conjunction with the de-installation 
of a service from a machine, 

nlsadmin -e service netjspec 

nlsadmln -d service netspec 

Enables or disables (respectively) the service indi- 
cated by service for the specified network 
net spec. The service must have previously been 
added to the listener for that network (see the -a 
option, above). Disabling a service causes subse- 
quent service requests for that service to be 
denied, but the processes from any prior service 
requests that are still running will continue unaf- 
fected. 

nlsadmin -s net spec 

nlsadmin -k net spec 

Start and kill (respectively) the listener process for 
the indicated network netjspec. These operations 
are normally performed as part of the system 
startup and shutdown procedures. Before a 
listener can be started for a particular network, it 
must first have been initialized, and an address 
must be defined for the General Listener Service 
(see the -1 and -I options, above). When a listener 
is killed, processes that are still running as a result 
of prior service requests will continue unaffected. 

The listener runs under its own ID of listen, with group ID 
adm. This ID must be entered in the system password file 
/etc/passwd; the HOME directory listed for that ID is con- 
catenated with netjspec to determine the location of the 
listener configuration information for each network. 

Nlsadmin may be invoked by any user to generate reports, 
but all operations that affect a listener's status or configura- 
tion are restricted to the super-user. 

FILES 

/usr/net/nls/servcodes 
/usr/net/nls/nef_spec 

SEE ALSO 

getty(1M). 
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servcodes{4), rf master (4), resolvers(5) in the Programmer's 
Reference Manual. 

System V Operating System Network Programmer's Guide. 
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NAME 

nmlmaint - loadable driver name list maintenance 

SYNOPSIS 

/etc/iddrv/nmlmaint -a driver 

/etc/lddrv/nmlmaint -d driver 

/etc/lddrv/nmimaint -D 

DESCRIPTION 

This program is used to update the ioadabie driver name list in 
/etc/lddrv/unix.sym. It is usually run automatically at system 
initialization time to purge the symbol file of stale information 
so that it can be updated with the symbols of current loadable 
drivers. 

Nmlmaint has three options: 

-a Adds the symbols in the file /etc/lddrv/oVvVer to the list in 
/etc/lddrv/unix.sym, 

«d Causes the symbols associated with the driver to be 
deleted from /etc/lddrv/unix.sym. 

-D Causes symbols associated with all loadable drivers to be 
deleted, leaving only the symbols associated with /unix 
itself. 

Nmlmaint is used by the Iddrv (1M) command to maintain the 
loadable driver name list in /etc/lddrv/unix.sym. 

FILES 

/etc/lddrv/unix.sym 
/etc/lddrv/oV/Ver 

SEE ALSO 

lddrv{lM), mkifile(IM). 
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NAME 

nsquery - Remote File Sharing name server query 

SYNOPSIS 

nsquery [ -h ] [ name ] 

DESCRIPTION 

Nsquery provides information about resources available to the 
host from both the local domain and from other domains. Ail 
resources are reported, regardless of whether the host is 
authorized to access them. When used with no options, 
nsquery identifies all resources in the domain that have been 
advertised as sharable. A report on selected resources can be 
obtained by specifying name, where name is: 

nodename The report will include only those 

resources available from nodename, 

domain. The report will include only those 

resources available from domain, 

domain.nodename The report will include only those 
resources available from 

domain.nodename . 

When the name does not include the delimiter it will be 
interpreted as a nodename within the local domain. If the 
name ends with a delimiter it will be interpreted as a 
domain name. 

The information contained in the report on each resource 
includes its advertised name (domain.resource), the read/write 
permissions, the server (nodename.domain) tnat advertised 
the resource, and a brief textual description. 

When -h is used, the header is not printed. 

A remote domain must be listed in your rfmaster file in order 
to query that domain. 

EXIT STATUS 

If no entries are found when nsquery is executed, the report 
header is printed. 

ERRORS 

If your host cannot contact the domain name server, an error 
message will be sent to standard error. 
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SEE ALSO 

adv(1M), unadv(lM). 

rf master (4) in the Programmer's Reference Manual. 
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NAME 

profiler: prfld, prfstat, prfde, prlsnap, prfpr - 6000/50 system 
profiler 

SYNOPSIS 

/etc/prfld [ systemjiamelists ... ] 

/etc/prfstat on 

/etc/prfstat off 

/etc/prfdc file [ period [ off_hour ] ] 
/etc/prfsnap file 

/etc/prfpr file [ cutoff [ systemjiamelists ... ] ] 
DESCRIPTION 

Prfld, prfstat, prfdc t prfsnap, and prfpr form a system of pro- 
grams to facilitate an activity study of the System V operating 
system. A kernel configured with kernel profiling must be 
used. 

Prfld is used to initialize the recording mechanism in the sys- 
tem. It generates a table containing the starting address of 
each system subroutine as extracted from system _namelist 
files. If no name lists are given, /unix is used. More than one 
name list may be given; for example, if loadable drivers are 
present in the system, /unix as well as several loadable driver 
name lists in /etc/lddrv may be given. 

Prfstat is used to enable or disable the sampling mechanism. 
Profiler overhead is less than 1% as calculated for 500 text 
addresses. Prfstat will also reveal the number of text 
addresses being measured. 

Prfdc and prfsnap perform the data collection function of the 
profiler by copying the current value of all the text address 
counters to a file where the data can be analyzed. Prfdc will 
store the counters into file every period minutes and will turn 
off at off hour (valid values for off hour are 0-24). Prfsnap 
collects data at the time of invocation only, appending the 
counter values to file, 

Prfpr formats the data collected by prfdc or prfsnap. Each 
text address is converted to the nearest text symbol (as found 
in system jiamelist) and is printed if the percent activity for 
that range is greater than cutoff. 
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FILES 

/dev/prf interface to profile data and text addresses 
/unix default for system namelist file 
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NAME 

pwck, grpck - password/group file checkers 

SYNOPSIS 

/etc/pwck [ file ] 

/etc/grpck [ file ] 

DESCRIPTION 

Pwck scans the password file and notes any inconsistencies. 
The checks include validation of the number of fields, login 
name, user ID, group ID, and whether the login directory and 
the prograrn-to-use-as-Shett exist. The default password file is 
/etc/passwd. 

Grpck verifies all entries in the group file. This verification 
includes a check of the number of fields, group name, group 
ID, and whether all login names appear in the password file. 
The default group file is /etc/group. 

FILES 

/etc/group 
/etc/passwd 

SEE ALSO 

group(4), passwd(4) in the Programmer's Reference Manual. 

DIAGNOSTICS 

Group entries in /etc/group with no login names are flagged. 
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NAME 

qinstall - install and verify software using the mkfs(1M) proto 
file database 

SYNOPSIS 

/usr/Iocat/bin/qinstall -c [ -esoim ] proto root 

/usr/local/bin/qinstall -g [ -p prefix ] [ -t # ] root 

/usr/local/bin/qinstall -r [ -q ] proto root from_rfile 
to_rfile 

DESCRIPTION 

Qinstall is used to package software on distribution media, to 
install software, and to verify the correctness of the installa- 
tion. Output from qinstall goes to standard output, floor 
must be a full pathname or 

The following options are recognized by qinstall: 

-V Output additional, verbose messages to stderr . 

-c Check whether files under root match files in proto for 
owner and permission. This option is used primarily to ver- 
ify the correctness of an installation, but it is also used in 
the software distribution packaging process. 

-o Print omissions from roof. 

-s Set permissions and owners to be correct if incorrect. 

-e Print extra files not found in . proto 

-i Ignore differences in special files. 

-m Check mounted file systems as well. 

-g Generate a proto file from root. This option is used in the 
software distribution packaging process. 

-p Add specified prefix to path names. 

-t Specify number of tabs to indent. 

-r Replace file tojfile in root with contents of from jf He, 
keeping permissions as in proto. Tojfile path must be a 
full path name as in the proto file, and will be offset with 
root. Multiple from/to pairs may be specified. This option 
is used to install customizable software. 

-q Query before replace. Options are to replace tojfile 
with from jf He, to save from jf He, to ignore tojfile, to 
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perform an sdiff(\) between the two files or to 
replace tojfile with the previous dlff. 



EXAMPLE 

A sample proto file created with the 
stall -g . > . ./proto) 



»g option follows, (qin- 



/mkboot 
0 0 

install 

IsamRel 
$ 



usr 



Include 

I sere. h 
isam.h 

$ 

lib 



d- 



isam 
IsamConfig --• 
IsamCreate -- 
IsamProtect - - 
IsamReorg 
IsamStat 
IsamStop 
IsamTransfer 
IxFHter 
IxSpec ---755 
isam 
$ 

libisam.a 
$ 

$ 



d--777 2 2 
d--775 0 0 

WOO /install/IsamRel 

d--775 2 2 
d--775 2 2 

— itii4 2 2 /usr/ include/i sere. h 
---4M 2 2 /usr/include/isam.h 

d--775 2 2 
775 2 2 

•755 2 2 /usr/1 ib/isam/IsamConfig 
■755 2 2 /usr/lib/ isam/ IsamCreate 
-755 2 2 /usr/lib/ isam/ IsamProtect 
-755 2 2 /usr/lib/ isam/ IsamReorg 
---755 2 2 /usr/1 ib/isam/IsamStat 
---755 2 2 /usr/1 ib/ isam/ IsamStop 

— 755 2 2 /usr/lib/ isam/ IsamTransfer 
-755 2 2 /usr/lib/isam/lxFilter 

2 2 /usr/lib/ isam/ IxSpec 
-755 2 2 /usr/1 ib/isam/fsam 

-WW 2 2 /usr/lib/libisam.a 



SEE ALSO 

qlist(1M), ctinstall(IM), mkfs(1M). 

BUGS 

Qinstall invoked with the -m option on an inconsistent file sys- 
tem produces error messages of the form "filename: cannot 
stat n . 
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NAME 

qlist - print out file lists from proto file; set links based on lines 
in proto file. 

SYNOPSIS 

/usr/iocal/bin/qlist -m [ -d dir ] [ -o ] [ -p prefix ] proto 
/usr/Iocal/bin/qlist -I dir [ -p prefix ] proto 
/usr/local/bin/qlist -s proto root 
DESCRIPTION 

Qlist is used in the distribution software packaging process 
and in the software installation process. It makes lists of files 
from proto files created by qinstall (1M). Lists are based on 
the files' group identifiers and types. Qlist also sets links 
based on lines in the proto file during software installation. 

Qlist understands extended proto files, in which a line begin- 
ning with :L indicates that the first file named is a link to the 
second file. Other lines beginning with : are comments. The 
last field on a line in an extended proto file is a group identifier 
of 9 or fewer characters, such as "WP" for the Word Proces- 
sor product. The following symbols appearing immediately 
after the group identifier designate the file's type and have the 
following meanings; 

+ designates a customizable file, such as /etc/passwd. This 
type of file is one which the user may or may not want to 
instaii over the existing version. This type of file can be 
installed with the -rq option of q/'nsfa//{1M). 

designates a zero-length file. The specified file should not 
be used when updating an existing system; rather, it 
should be used for raw, or first installs only. 

@ implies an update but no query from qinstall {1M). This 
symbol is used for files required by the installation tools 
for installation and for possible text busy files. 

< designates an optional file, or a file requiring special instal- 
lation such as a hardware configuration-dependent file. 
Its associated special installation scripts are GROUP .opt 
and GROUP. Ins, where GROUP represents the group 
name. 
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< id 

designates a file of the above category which has special 
installation scripts named GROUPid.opX, GROUPid.'ms, 
where GROUP represents the group name. Id can be 5 or 
fewer characters. The total number of characters in 
GROUP and id must be 10 or fewer. 

The following options are recognized by qlist : 

-V Output additional, verbose messages to stderr. 

•m Make file lists from proto file. This option is used in pack- 
aging software. 

-o Print files in no group. 

-d Use dir as location for file lists. 

-p Use prefix when printing (default = ./). 

For example, file lists output with the -m option for group 
"WP" are named as follows: 

4- WP.cust 

WP.noup 

@ WP.noqu 

< WP.fopt, WP.flst 

< Id WP.fopt, WPid.lst 
the rest WP 

-I List files in directory dir from proto file to stdout. 

-p Use prefix when printing (default = ./). 

-s Set links in roof directory which are indicated by :L lines 
in proto file. Hoof must be a rooted path name or This 
option is used in software installations. 

EXAMPLE 

A sample extended proto file follows. Note that the files Docu- 
ment and Gloss are really links to the file Admin, as indicated 
by :L at the beginning of these lines. Also note that the lines 
ending in < designate optionally installed, or specially 
installed files. 
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/mkboot 
0 0 

d--777 2 2 

install d--775 0 0 



WPRel 
$ 


-WOO /install/WPRel 


WP 




d- 


- 775 0 0 






.Key d- 


-755 0 0 






Admin 


2 2 /oa/. Key /Admin 




UNIX 


Document 


/oa/. Key /Admin 




UNIX 


Gloss 
$ 


/oa/. Key /Admin 




UNIX 


.Document d 


-775 0 0 






Recru i t 
$ 


--666 2 2 /oa/. Document/Recruit 


WP 


.Gloss d 


--775 0 0 






Sample 
$ 


--666 2 2 /oa/. Gloss/Sample 




WP 


Centronix 


--555 2 2 /oa/Centronix 


WP< 


sys 


ImagenDriver- 


--555 2 2 /oa/imagenDriver 


WP< 


sys 


SerialDriver- 


--555 2 2 /oa/Serial Driver 


WP< 


sys 


abs_rel 


--555 2 2 /oa/abs_rel 


WP< 


propt 


ctospool 


--555 2 2 /oa/ctospool 


WP 




def_wp 


--555 2 2 /oa/def_wp 


WP< 


propt 


spool stat 


--555 2 2 /oa/spoolstat 


WP 




wp_def 


--555 2 2 /oa/wp_def 


WP< 


propt 


wp_edit 


--555 2 2 /oa/wp_edit 


WP 




wp_merge 


--555 2 2 /oa/wp_merge 


WP 




wp_print 


--555 2 2 /oa/wp_print 


WP 




wp_revf ew 


--555 2 2 /oa/wpj-eview 


WP 




wpp__band 


--555 2 2 /oa/wpp_band 


WP< 


propt 


wpp_canprt - 


- - 555 2 2 /oa/wpp_canprt 


WP 




wpp__dfablo - 


--555 2 2 /oa/wpp_diablo 


WP< 


propt 


wpp_imagen - 


--555 2 2 /oa/wpp_imagen 


WP< 


propt 


wpp_l aser 


--555 2 2 /oa/wpp_laser 


WP< 


propt 


wpp_necspin - 


--555 2 2 /oa/wpp_necspin 


WP< 


propt 


wpp_prtsh - 


--555 2 2 /oa/wppj>rtsh 


WP 





$ 

$ 

SEE ALSO 

qinstal!(1M), ctinstali(IM). 
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NAME 

rcO - run commands performed to stop the operating system 

SYNOPSIS 
/etc/rcO 

DESCRIPTION 

This file is executed at each system state change that needs 
to have the system in an inactive state. It is responsible for 
those actions that bring the system to a quiescent state, tradi- 
tionally called "shutdown". 

There are three system states that require this procedure. 
They are state 4 (the system halt state), state 5 (the reboot 
state), and state 6 (the administration state). Whenever a 
change to one of these states occurs, the leiclrcO procedure 
is run. The entry in /etc/inittab might read: 

sO:OH*56:wait:/etc/rcO < /dev/consol e > /dev/console 2>&1 

Some of the actions performed by /etc/rcO are carried out by 
files beginning with K or S in /etc/rcO.d. These files are exe- 
cuted in ASCII order (see FILES below for more information), 
terminating some system services. 

The recommended sequence for letclrcO is: 

Stop System Services and Daemons. 

• Various system services (such as the LP Spooler) are 
gracefully terminated. 

• When new services are added that should be terminated 
when the system is shut down, the appropriate files are 
installed in /etc/rcO.d. 

Terminate Processes 

• SIGTERM signals are sent to all running processes by 
/f///a//(lM). Processes stop themselves cleanly if sent 
SIGTERM. 

Kill Processes 

• SIGKILL signals are sent to all remaining processes; no 
process can resist SIGKILL. 

• At this point the only processes left are those associated 
with letcfrcO and processes 0 and 1 , which are special to 
the operating system. 
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Unmount All File Systems 

• Only the root file system {/) remains mounted. 

Depending on which system state the system ends up in (4, 5, 
or 6), the entries in /etc/inittab will direct what happens next. 
If the /etc/inittab has not defined any other actions to be per- 
formed as in the case of system state 0, then the operating 
system will have nothing to do. It should not be possible to 
get the system's attention. The only thing that can be done is 
to turn off the power or possibly get the attention of a 
firmware monitor. 

This command can be used only by the super-user. 
RUES 

The execution by /bin/sh of any files in /etc/rcO.d occurs in 
ASCII sort-sequence order. See rc2 (1M) for more information. 

SEE ALSO 

killall(IM), rc2(1M), shutdown(IM). 
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NAME 

rc2 - run commands performed for multi-user environment 

SYNOPSIS 
/etc/rc2 

DESCRIPTION 

This file is executed via an entry in /etc/inittab and is respon- 
sible for those initializations that bring the system to a ready- 
to-use state, traditionally state 2, called the "multi-user" state. 

The actions performed by /etc/rc2 files beginning with S and 
K in /etc/rc2.d. These files are executed by /bin/sh in ASCII 
sort-sequence order (see FILES for more information). When 
functions are added that need to be initialized when the sys- 
tem goes multi-user, an appropriate file should be added in 
/etc/rc2.d. 

The functions done by /etc/rc2 command and associated 
/etc/rc2.d files include: 

• Setting the uucp node name and the NETWORK host 
name according to /etc/fstab. 

• Mounting file systems according to /etc/fstab. 

• Cleaning up (remaking) the /tmp and /usr/tmp directories. 

• Loading the network interface and ports cards (if any) 
with program data and starting the associated processes. 

• Starting the cron daemon by executing /etc/cron. 

• Cleaning up (deleting) uucp locks status, and temporary 
files in the /usr/spool/uucp directory. 

Other functions can be added, as required, to support the 
addition of hardware and software features. 

EXAMPLES 

The following are prototypical files found in /etc/rc2.d. These 
files are prefixed by an S or K and a number indicating the 
execution order of the files. 



UP-13529 



Page 1 



RC2(1M) 



MOUMTFILESYS 

# Set up and mount file systems 

cd / 

/etc/mountall /etc/fstab 

RMTMPFILES 

# clean up /tmp 
rro - rf /tmp 
mkdir /tmp 
chmod 777 /tmp 
chgrp sys /tmp 
chown sys /tmp 

uucp 

# clean-up uucp locks, status, and temporary files 

rm - rf /usr /spool /locks/* 

The file /etc/TIMEZONE is included early in Jetc/rc2, thus 
establishing the default time zone for all commands that fol- 
low. 

FILES 

Here are some hints about files in /etc/rc2.d: 

The order in which files are executed is important. Since they 
are executed in ASCII sort-sequence order, using the first 
character of the file name as a sequence indicator wilt help 
keep the proper order. Thus, files starting with the following 
characters would be: 

[0-9]. very early 
[A-ZJ. early 
[a-n]. later 
[o-zj. last 

Files in /etc/rc2.d must begin with an S or a K followed by a 
number and the rest of the file name. Upon entering run level 
2, files beginning with S are executed with the start option; 
files beginning with K, are executed with the stop option. 
Files beginning with other characters are ignored. 

SEE ALSO 

shutdown (1M). 
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NAME 

reboot - reboot the system 

SYNOPSIS 
/etc/reboot 

DESCRIPTION 

Reboot issues a uadmin{2) call to ask the system to wait for 
the disks to become quiescent and then to reboot the system. 
The reboot procedure is identical to power-on reset except 
that the system will not try to take a crash dump. 

Only super-user is allowed to execute reboot. 

WARNINGS 

This command is provided for compatibility. Uadmin (1M) 
should be used instead of reboot. 
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NAME 

renice - alter priority of running process by changing nice 

SYNOPSIS 

/usr/local/bin/renice pid [ priority ] 

DESCRIPTION 

Renice can be used by the super-user to alter the priority of a 
running process. By default, the nice value of the process is 
made '19', which means that it will run only when nothing else 
in the system wants to. This can be used to nail long-running 
processes that are interfering with interactive work. 

Renice can be given a second argument to choose a nice 
value other than the default. Negative nice values can be 
used to make things go very fast. 

FILES 

/unix 

/dev/kmem 

SEE ALSO 

nice(1). 

BUGS 

If you make the nice value very negative, then the process 
cannot be interrupted. To regain control you must put the 
nice value back (for example, to 0). 
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NAME 

rfadmin - Remote File Sharing domain administration 

SYNOPSIS 
rfadmin 

rfadmin -a hostname 
rfadmin -r hostname 
rfadmin -p 
DESCRIPTION 

Rfadmin is used to add and remove hosts and their associated 
authentication information from a domain /pass wd file on a 
Remote File Sharing primary domain name server. It is also 
used to transfer domain name server responsibilities from one 
machine to another. Used with no options, rfadmin returns 
the hostname of the current domain name server for the local 
domain. 

Rfadmin can only be used to modify domain files on the pri- 
mary domain name server (-a and -r options). If domain 
name server reponsibiiities are temporarily passed to a secon- 
dary domain name server, that computer can use the -p 
option to pass domain name server responsibility back to the 
primary. Any host can use rfadmin with no options to print 
information about the domain. The user must have root per- 
missions to use the command. 

-a hostname Used to add a host to a domain that is 
served by this domain name server. Host- 
name must be of the form 
domain. nodename . It creates an entry for 
hostname in the c/oma/n/passwd file, which 
has the same format as /etc/passwd, and 
prompts for an initial authentication pass- 
word; the password prompting process con- 
forms with that of passed (1). 

-r hostname Used to remove a host from its domain by 
removing it from the domam/passwd file. 

•p Used to pass the domain name server 

responsibilities back to a primary or to a 
secondary name server. 
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ERRORS 

When used with the -a option, if hostname is not unique in the 
domain, an error message is sent to the standard error. 

When used with the -r option, if (1) hostname does not exist in 
the domain, (2) hostname is defined as a domain name server, 
an error message will be sent to standard error. 

When used with the -p option to change the domain name 
server, if there are no backup name servers defined for 
domain, an error message will be sent to standard error. 

FILES 

/usr/nserve/auth.info/doma/n/passwd 

For each domain, this file is created on the primary, 
should be copied to all secondaries, and should be copied 
to all hosts that want to do password verification of hosts 
in the domain.) 

SEE ALSO 

rfstart(lM), rfstop(1M). 



Page 2 



UP-13529 



RFPASSWD(IM) 



NAME 

rfpasswd - change Remote File Sharing host password 

SYNOPSIS 
rfpasswd 

DESCRIPTION 

Rfpasswd updates the Remote . File Sharing authentication 
password for a host; processing of the new password follows 
the same criteria as passwd{1). The updated password is 
registered at the domain name server 
(/usr/n serve/a uth.lnfo/cfo/na/rt/passwd) and replaces the 
password stored at the local host (/usr/nserve/loc.passwd 
file). 

This command is restricted to the super-user. 

Note: If you change your host password, make sure that 
hosts that validate your password are notified of this change. 
To receive the new password, hosts must obtain a copy of the 
ctoma/n/passwd file from the domain's primary name server. 
If this is not done, attempts to mount remote resources may 
fail! 

ERRORS 

If (1) the old password entered from this command does not 
match the existing password for this machine, (2) the two new 
passwords entered from this command do not match, (3) the 
new password does not satisfy the security criteria in 
passwd{\), (4) the domain name server does not know about 
this machine, or (5) the command is not run with super-user 
privileges, an error message will be sent to standard error. 
Also, Remote File Sharing must be running on your host and 
your domain's primary name server. A new password cannot 
be logged if a secondary is acting as the domain name server. 

FILES 

/usr/nserve/auth.info/doma/n/passwd 
/usr/nserve/ioc. passwd 

SEE ALSO 

rfstart(lM), rfadmin(IM). 
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NAME 

rfstart - start Remote File Sharing 

SYNOPSIS 

rfstart [ -v ] [ -p primary_addr ] 

DESCRIPTION 

Rfstart starts Remote File Sharing and defines an authentica- 
tion level for incoming requests. (This command can only be 
used after the domain name server is set up and your 
computer's domain name and network specification has been 
defined using dname(1M),) 

-v Specifies that verification of ail clients is required in 
response to initial incoming mount requests; any host not 
in the file /usr/nserve/authJnfo/doma/n/passwd for the 
domain they belong to, will not be allowed to mount 
resources from your host. If -v is not specified, hosts 
named in domain /passwd will be verified; other hosts will 
be allowed to connect without verification. 

-p primary _addr 

Indicates the primary domain name server for your 
domain. Primary Jtddr must be the network address of 
the primary name server for your domain. If the -p option 
is not specified, the address of the domain name server is 
taken from the rfmaster file. (See rfmaster for a 
description of the valid address syntax.) 

If the host password has not been set, rfstart will prompt for a 
password; the password prompting process must match the 
password entered for your machine at the primary domain 
name server [see rfadmin (1M)]. If you remove the 
loc.passwd file or change domains, you will also have to 
reenter the password. 

Also, when rfstart is run on a domain name server, entries in 
the rfmaster {4) file are syntactically validated. 

This command is restricted to the super- user. 

ERRORS 

If syntax errors are found in validating the rfmaster (4) file, a 
warning describing each error will be sent to standard error. 

If (1) the shared resource environment is already running, (2) 
there is no communications network, (3) the domain name 
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server cannot be found, (4) the domain name server does not 
recognize the machine, or (5) the command is run without 
super-user privileges, an error message will be sent to stan- 
dard error. 

Remote file sharing will not start if the host password in 
/usr/nserve/loc.passwd is corrupted. If you suspect this has 
happened, remove the file and run rfstart again to reenter 
your password. 

Note: rfstart will NOT fail if your host password does not 
match the password on the domain name server. You will 
simply receive a warning message. However, if you try to 
mount a resource from the primary or any other host that vali- 
dates your password, the mount will fail if your password does 
not match the one that host has listed for your machine. 

FILES 

/usr/nserve/rfmaster 
/usr/nserve/loc. passwd 

SEE ALSO 

adv(1M), dname(lM), mount(lM), rfadmin(lM), rfstop(1M), 
unadv(1M). 

rf master (4) in the Programmer's Reference Manual. 
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NAME 

rfstop - stop the Remote File Sharing environment 

SYNOPSIS 
rfstop 

DESCRIPTION 

Rfstop disconnects a host from the Remote File Sharing 
environment until another rfstartfi M) is executed. 

When executed on the domain name server, the domain name 
server responsibility is moved to a secondary name server as 
designated in the rfmaster file. 

This command is restricted to the super- user. 

ERRORS 

If (1) there are resources currently advertised by this host, (2) 
resources from this machine are still remotely mounted by 
other hosts, (3) there are still remotely mounted resources in 
the local file system tree, (4) rf start (1M) had not previously 
been executed, or (5) the command is not run with super-user 
privileges, an error message will be sent to standard error. 

SEE ALSO 

adv(1M), mount(1M), rfadmin(IM), rfstart(1M) t unadv(1M). 
rfmaster(4) in the Programmer's Reference Manual. 
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NAME 

rfuadmin - Remote File Sharing notification shell script 
SYNOPSIS 

rfuadmin message remote_resource [ seconds ] 
DESCRIPTION 

The rfuadmin administrative shell script responds to unex- 
pected Remote File Sharing events, such as broken network 
connections and forced unmounts, picked up by the rfudae- 
mon process. This command is not intended to be run 
directly from the shell. 

The response to messages received by rfudaemon can be 
tailored to suit the particular system by editing the rfuadmin 
script. The following paragraphs describe the arguments 
passed to rfuadmin and the responses. 

disconnect remote jesource 

A link to a remote resource has been cut. Rfudaemon 
executes rfuadmin, passing it the message disconnect 
and the name of the disconnected resource. Rfuadmin 
sends this message to all terminals using wa//(1): 

Remote jesource has been disconnected from the sys- 
tem. 

Then it executes fuser(1M) to kill all processes using the 
resource, unmounts the resource [umount (1M)] to clean 
up the kernel, and starts rmount to try to remount the 
resource. 

f umount remoferesource 

A remote server machine has forced an unmount of a 
resource a local machine has mounted. The processing is 
similar to processing for a disconnect. 

fuwarn remote jesource seconds 

This message notifies rfuadmin that a resource is about to 
be unmounted. Rfudaemon sends this script the fuwarn 
message, the resource name, and the number of seconds 
in which the forced unmount will occur. Rfuadmin sends 
this message to all terminals: 

Remote jesource is being removed from the system in # 
seconds. 
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SEE ALSO 

fumount(IM), rmount(1M), rfudaemon(IM), rfstart(IM). 
wall(1) in the User's Reference Manual. 

BUGS 

The console must be on when Remote File Sharing is running. 
If not, rfuadmin will hang when it tries to write to the console 
(wall) and recovery from disconected resources will not com- 
plete. 
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NAME 

rfudaemon - Remote File Sharing daemon process 

SYNOPSIS 
rfudaemon 

DESCRIPTION 

The rfudaemon command is started automatically by 
rf start (1M) and runs as a daemon process as long as Remote 
File Sharing is active. Its function is to listen for unexpected 
events, such as broken network connections and forced 
unmounts, and execute appropriate administrative procedures. 

When such an event occurs, rfudaemon executes the adminis- 
trative shell script rfuadmin, with arguments that identify the 
evert. This command is not intended to be run from the shell. 
Here are the events: 

DISCONNECT 

A link to a remote resource has been cut. Rfudaemon 
executes rfuadmin, with two arguments: disconnect and 
the name of the disconnected resource. 

FUMOUNT 

A remote server machine has forced an unmount of a 
resource a local machine has mounted. Rfudaemon exe- 
cutes rfuadmin, with two arguments: fumount and the 
name of the disconnected resource. 

GETUMSG 

A remote user- level program has sent a message to the 
local rfudaemon. Currently the only message sent is 
fuwarn, which notifies rfuadmin that a resource is about to 
be unmounted. It sends rfuadmin the fuwarn, the 
resource name, and the number of seconds in which the 
forced unmount will occur. 

LASTUMSG 

The local machine wants to stop the rfudaemon 
[rfstop (1M)]. This causes rfudaemon to exit. 

SEE ALSO 

rfstart(IM), rfuadmin(IM). 
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NAME 

rmntstat - display mounted resource information 

SYNOPSIS 

rmntstat [ -h ] [ resource j 

DESCRIPTION 

When used with no options, rmntstat displays a list of all local 
Remote File Sharing resources that are remotely mounted, the 
local path name, and the corresponding clients. Rmntstat 
returns the remote mount data regardless of whether a 
resource is currently advertised; this ensures that resources 
that have been unadvertised but are still remotely mounted 
are included in the report. When a resource is specified, 
rmntstat displays the remote mount information only for that 
resource. The -h option causes header information to be 
omitted from the display. 

EXIT STATUS 

If no local resources are remotely mounted, rmntstat will return 
a successful exit status. 

ERRORS 

If resource (1) does not physically reside on the local machine 
or (2) is an invalid resource name, an error message will be 
sent to standard error. 

SEE ALSO 

mount{1M), fumount(IM), unadv(1M). 
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NAME 

rmount - retry remote resource mounts 

SYNOPSIS 

/etc/rmount -d [ r ] special directory 

DESCRIPTION 

Rmount is an administrative shell script that tries to mount 
remote resource special on directory, If the remote mount is 
unsuccessful, rmount will wait 60 seconds and try to mount 
the resource again. This will repeat forever. The RETRIES = 0 
value in the shell script can be changed to limit the number of 
times the shell script will try to mount a remote resource. The 
wait time (TIME -60) can also be changed. 

See mount {1M) for a description of the options. 

FILES 

/etc/mnttab mount table 
SEE ALSO 

fumount(IM), fuser(1M), mount(lM), rfstart(lM), 

rfuadmin(lM), setmnt(1M). 

mnttab(4) in the Programmer's Reference Manual, 
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NAME 

rmountall, rumountall - mount, unmount Remote File Sharing 
resources 

SYNOPSIS 

/etc/rmountall [ - ] file-system-table [ ... ] 

/etc/rumountall [ -k ] 

DESCRIPTON 

Rmountall is a Remote File Sharing command used to mount 
remote resources according to a file-system-table (/etc/fstab 
is the recommended fife-system-table.) The special file name 
"-" reads from the standard input. 

Rumountall causes all mounted remote resources to be 
unmounted. The -k option sends a SIGKILL signal, via 
fuser (1M), to processes that have files open. 

These commands may be executed only by the super-user. 

The file-system-table format is as follows: 

Column 1 Block special file name of file system. 

Column 2 Mount- point directory. 

Column 3 -r if to be mounted read-only; 
-d if remote resource. 

Column 4 File system type (not used with Remote File 
Sharing). 

Column 5+ Ignored. 

White-space separates columns. Lines beginning with are 
comments. Empty lines are ignored. 

SEE ALSO 

fuser(1M), mount(1M), rfstart(IM), 

signal(2) in the Programmer's Reference Manual. 

DIAGNOSTICS 

No messages are printed if the remote resources are mounted 
successfully. 

Error and warning messages come from mounf(1M). 
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NAME 

runacct - run daily accounting 

SYNOPSIS 

/usr/lib/acct/runacct [ mmdd [ state ] ] 

DESCRIPTION 

Runacct is the main daily accounting shell procedure. It is 
normally initiated via cron (1M). Runacct processes connect, 
fee, disk, and process accounting files. It also prepares sum- 
mary files for prdaily or billing purposes. Disk block counts 
are reported for 512-byte blocks. 

Runacct takes care not to damage active accounting files or 
summary files in the event of errors. It records its progress 
by writing descriptive diagnostic messages into active. When 
an error is detected, a message is written to /dev/console, 
mail [see ma/7(1)] is sent to root and adm, and runacct ter- 
minates. Runacct uses a series of lock files to protect against 
re-invocation. The files lock and fockl are used to prevent 
simultaneous invocation, and lastdate is used to prevent more 
than one invocation per day. 

Runacct breaks its processing into separate, restartable states 
using statefile to remember the last state completed. It 
accomplishes this by writing the state name into statefile. 
Runacct then looks in statefile to see what it has done and to 
determine what to process next. States are executed in the 
following order: 

SETUP 

WTMPRX 

CONNECT1 

CONNECT2 
PROCESS 

MERGE 
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Move active accounting files into working files. 

Verify integrity of wtmp file, correcting date 
changes if necessary. 

Produce connect session records in ctmp.h 
format. 

Convert ctmp.h records into tacct.h format. 

Convert process accounting records into 
tacct.h format. 

Merge the connect and process accounting 
records. 
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FEES 



Convert output of chargefee into tacct.h for- 
mat and merge with connect and process 
accounting records. 



DISK 



Merge disk accounting records with connect, 
process, and fee accounting records. 



MERGETACCT 



Merge the daily total accounting records in 
daytacct with the summary total accounting 
records in /usr/adm/acct/sum/tacct. 



CMS 



Produce command summaries. 



USEREXIT Any installation-dependent accounting pro- 
grams can be included here. 

CLEANUP Cleanup temporary files and exit. 

To restart runacct after a failure, first check the active file for 
diagnostics, then fix up any corrupted data files such as pacct 
or wtmp. The lock files and lastdate file must be removed 
before runacct can be restarted. The argument mmdd is 
necessary if runacct is being restarted, and specifies the 
month and day for which runacct will rerun the accounting. 
Entry point for processing is based on the contents of sta- 
teflle; to override this, include the desired sfafe on the com- 
mand line to designate where processing should begin. 

EXAMPLES 

To start runaccf: 

nohup runacct 2> /usr/adm/acct/nJte/fd21og & 
To restart runacct: 

nohup runacct 0601 2» /usr/adm/acct/nite/fd21og & 
To restart runacct at a specific state: 
nohup runacct 0601 MERGE 2» /usr/adro/acct/nite/fd21og & 
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FILES 

/etc/wtmp 

/usr/adm/pacct* 

/usr/src/cmd/acct/tacct.h 

/usr/src/cmd/acct/ctmp.h 

/usr/adm/acct/nite/active 

/usr/adm/acct/nite/daytacct 

/usr/adm/acct/nite/lock 

/usr/adm/acct/nite/lock1 

/usr/adm/acct/nite/lastdate 

/usr/adm/acct/nite/statefile 

/usr/adm/acct/nite/ptacct*.mmdd 

SEE ALSO 

acct(1M), acctcms(IM), acctcon(lM), acctmerg(IM), 

acctprc(lM), acctsh(1M), cron(1M). 

acctcom(1), mail(1) in the User's Reference Manual. 

acct(2), acct(4), utmp(4) in the Programmer's Reference 

Manual, 

BUGS 

Normally it is not a good idea to restart runacct in the SETUP 
state. Run SETUP manually and restart via: 

runacct mmdd WTMPFIX 

If runacct failed in the PROCESS sfafe, remove the last ptacct 
file because it will not be complete. 
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NAME 

sadp - disk access profiler 
SYNOPSIS 

sadp { -th ] [ -d device [ -drive ] ] s [ n ] 
DESCRIPTION 

Sadp reports disk access location and seek distance, in tabu- 
lar or histogram form. It samples disk activity once every 
second during an interval of s seconds. This is done repeat- 
edly if n is specified. Cylinder usage and disk distance are 
recorded in units of 8 cylinders. 

The valid value of device Is disk. Drive specifies the disk 
drives and it may be: 

• a drive number in the range supported by device, 

• two numbers separated by a minus (indicating an 
inclusive range), or 

• a list of drive numbers separated by commas. 

Up to 8 disk drives may be reported. The -d option may be 
omitted, if only one device is present. 

The -t flag causes the data to be reported in tabular form. 
The -h flag produces a histogram on the printer of the data. 
Default is -t. 

EXAMPLE 

The command: 

sadp ~d disk-0 900 4 

will generate 4 tabular reports, each describing cylinder usage 
and seek distance of disk drive 0 during a 15-minute interval. 

FILES 

/dev/kmem 

SEE ALSO 

mem (7). 
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NAME 

sar: sal , sa2, sadc - system activity report package 

SYNOPSIS 

/usr/lib/sa/sadc [ t n ] [ ofile ] 

/usr/lib/sa/sa1 [ t n ] 

/usr/Iib/sa/sa2 [ -ubdycwaqvmprSDAC ] [ -s time ] 
[ -e time ] [ -i sec ] 

DESCRIPTION 

System activity data can be accessed at the special request of 
a user [see sar(1)] and automatically on a routine basis as 
described here. The operating system contains a number of 
counters that are incremented as various system actions 
occur. These include counters for CPU utilization, buffer 
usage, disk and tape I/O activity, TTY device activity, switching 
and system-call activity, file-access, queue activity, inter- 
process communications, paging and Remote File Sharing. 

Sadc and shell procedures, saT and sa2, are used to sample, 
save, and process this data. 

Sadc, the data collector, samples system data n times every f 
seconds and writes in binary format to ofile or to standard 
output. If t and n are omitted, a special record is written. This 
facility is used at system boot time, when booting to a mul- 
tiuser state, to mark the time at which the counters restart 
from zero. For example, the /etc/init.d/perf file writes the res- 
tart mark to the daily data by the command entry: 

su sys -c "/usr/l fb/sa/sadc /usr/adm/sa/sa % date +%cT M 

The shell script sa1 t a variant of sadc, is used to collect and 
store data in binary file /usr/adm/sa/sadd where dd is the 
current day. The arguments f and n cause records to be writ- 
ten n times at an interval of t seconds, or once if omitted. The 
entries in /usr/spool/cron/crontabs/sys [see cron (1M)]: 

0***0-6 /usr/l ib/sa/sal 

20,40 8-17 * * 1-5 /usr/l ib/sa/sal 
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will produce records every 20 minutes during working hours 
and hourly otherwise. 

The shell script sa2, a variant of sar(1), writes a daily report in 
file /usr/adm/sa/sardd. The options are explained in sar(1), 
The /usr/spool/cron/crontabs/sys entry: 

5 18 * * 1-5 /usr/1ib/sa/sa2 -s 8:00 -e 18:01 - i 3600 - A 

will report important activities hourly during the working day. 
The structure of the binary daily data file is: 
struct sa \ 

struct sysinfo slj /* see /usr/include/sys/sysinfo.h */ 
struct minfo mi; /* defined in sys/sysinfo.h */ 
struck dinfo di; /* RFS info defined in */ 

/* sys/sysinfo.h */ 
int minserve, maxserve; /* RFS server low and high */ 







/* water marks */ 


int 


szinode; 


/* current size of i-node table */ 


int 


szf ile; 


/* current size of file table */ 


int 


szproc; 


/* current size of proc table */ 


int 


szlckf; 


/* current size of file record */ 






/* header table */ 


int 


szlckr; 


/* current size of file record */ 






/* lock table */ 


int 


mszinode; 


/* size of i-node table */ 


int 


mszf ile; 


/* size of file table */ 


int 


mszproc; 


/* size of proc table */ 


int 


mszlckf ; 


/* maximum size of file record */ 






/* header table */ 


int 


mszlckr; 


/* maximum size of file record */ 






/* lock table */ 


long 


inodeovf ; 


/* cumulative overflows of i-node 1 






/* table */ 


long 


f ileovf ; 


/* cumulative overflows of file */ 






/* table */ 


long 


procovf ; 


/* cumulative overflows of proc */ 






/* table */ 


time 


_t ts; 


/* time stamp, seconds */ 



long deviolNDEVS][4J; /* device unit information */ 

#define 10_0PS 0 /* cumulative I/O requests */ 

#define I0_BCNT 1 /* cumulative blocks */ 
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#define IO_ACT 
#define IO_RESP 



/* transferred */ 

/* cumulative drive busy */ 

/* time in ticks */ 

/* cumulative I/O resp */ 

/* time in ticks */ 



i; 

FILES 

/usr/adm/sa/sadof 
/usr/adm/sa/sardc/ 
/tmp/sa.adrfl 

SEE ALSO 

cron(1M). 

sag(lG), sar(1), timex(1) in the User's Reference Manual. 



daily data file 
daily report file 
address file 
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NAME 

scpioctl - download code to active SCP boards. 

SYNOPSIS 

/etc/scpioctl file 

DESCRIPTION 

Scpioctl opens the special file /dev/scp and uses the SCPAT- 
TACH ioctl command to download the specified code file to all 
active SCP boards. 

The file /etc/scpmon.out contains the download code 
expected. If the scp driver is loaded at boot time, the rc2 
script automatically invokes the following command: 

scpioctl /etc/scpmon.out 

Note that if the scp driver is loaded manually and the 
/etc/master file specifies active SCP boards, the command 
shown above must be issued before the active SCP boards 
are operational. 

FILES 

/etc/scpmon.out 

SEE ALSO 

SCp(7). 

DIAGNOSTICS 

Scpioctl silently fails if it is unable to open /dev/scp, which 
happens if the scp driver is not loaded or if there are no active 
SCP boards in the system. Any other errors produce self- 
explanatory messages. 
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NAME 

scsicnfg - configure devices on the SCSI bus 

SYNOPSIS 

scsicnfg [ -deu ] [ -s specfile ] 

DESCRIPTION 

Scsicnfg is used to examine and set up configuration parame- 
ters for devices attached to the SCSI bus. Normally, it is 
called by the startup file, /etc/inittab. 

The following options are available: 

-d Displays the SCSI bus configurations currently in 

effect. 

-e Examines the file specified by -s specfile and 

prints any invalid lines with a diagnostic message. 
If no -s specfile is given, /etc/scsiconfig is exam- 
ined. 

-u Configure the SCSI bus using the configuration 

file given by -s specfile. If any entry in the 
specfile is invalid, or the drive to be remapped is 
busy or non-existent, an error message is 
returned and no configuration is done. 

-s specfile Specify the configuration file specfile to be used 
by the -e or »u option. 

The specfile contains the following required information: 

scsibusno Number of SCSI busses installed in the system. 

targetid SCSI target ID number for the device. 

lun SCSI logical unit number for the device. 

The following SCSI options can be included; see scsi{7) for 
more information: 

parity Enable parity on the SCSI bus. 

reselect Enable the disconnect-reconnect feature for the 
target device. 

sync Use synchronous protocol instead of the default 

asynchronous protocol. When the -u option is 
specified, scsicnfg attempts to communicate with 
the target in sync mode; if communications fail, 
configuration stops at the failing entry in the 
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specfile. 

Lines in the fiie beginning with # are treated as comments. 
EXAMPLES 

The following specfile sets up the parameters for two SCSI 
disk drives: 

/dev/rdsk/cOdl scsibusno=0 target!d=3 lun=0 parity reselect 
/dev/rdsk/c0d2 scsibusno=0 target id=1 lunsO parity reselect 

The following example configures a SCSI QIC device: 

/dev/rmtO scsibusno=0 target id=1 lun=0 parity reselect 

/dev/rmtl scsibusno=0 target id=5 lun=0 parity reselect 

The following example configures a SCSI tape device: 

/dev/roit/cldO scsibusno=0 target id=6 lun=0 parity reselect 

FILES 

/etc/scsisystem default configuration file 

SEE ALSO 

scsi(7). 
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NAME 

setmnt - establish mount table 

SYNOPSIS 
/etc/setmnt 

DESCRIPTION 

Setmnt creates the /etc/mnttab table [see mnttab (4)] which is 
needed for both the mount (1M) and umount commands, 
Setmnt reads standard Input and creates a mnttab entry for 
each line. Input lines have the format: 

filesys node 

where filesys is the name of the file system's special file (for 
example, /dev/dsk/c?d?$?) and node is the root name of 
that file system. Thus filesys and node become the first two 
strings in the mount table entry. 

FILES 

/etc/mnttab 

SEE ALSO 

devnm{1M) t mount(1M). 

mnttab (4) in the Programmer's Reference Manual. 
BUGS 

Problems may occur if filesys or node is longer than 32 char- 
acters. 

Setmnt silently enforces an upper limit on the maximum 
number of mnttab entries. 
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NAME 

shutdown, halt - shut down system, change system state 
SYNOPSIS 

/etc/shutdown [ -y ] [ -m message J [ -g grace_period ] 
[ -i init_state ] 

DESCRIPTION 

This command is executed by the super-user to change the 
state of the machine. By default, it brings the system to a 
state where only the console has access to the 6000/50 sys- 
tem. This state is traditionally called "single-user." 

The command sends a warning message and a final message 
before it starts actual shutdown activities. By default, the 
command asks for confirmation before it starts shutting down 
daemons and killing processes. The options are used as fol- 
lows: 

-y Pre-answers the confirmation question so the command 
can be run without user intervention, A default of 60 
seconds is allowed between the warning message and the 
final message. Another 60 seconds is allowed between 
the final message and the confirmation. 

-mmessage 

Specifies a message to be sent to each user before the 
system is shut down. 

•ggrace j>eriod 

Allows the super-user to change the number of seconds 
from the 60-second default. 

-Vnitjstate 

Specifies the state in which ;n/f(1M) is to be put following 
the warnings, if any. By default, system state "s" is used 
(the same as states "1" and "S"). 

Other recommended system state definitions are: 

state 0 

Shut the machine down so it is safe to remove the power. 
Have the machine remove power if it can. The /etc/rcO 
procedure is called to do this work. 

state 1 , s, S 

Bring the machine to the state traditionally called single- 
user. The fetclrcO procedure is called to do this work. 
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(Though s and 1 are both used to go to single user state, 
s only kills processes spawned by init and does not 
unmount file systems. State 1 unmounts everything 
except root and kills all user processes, except those that 
relate to the console.) 

state 5 

Bring the machine to administration mode, 
state 6 

Stop the 6000/50 system and reboot to the state defined 
by the initdefault entry in /etc/inittab. 

SEE ALSO 

init(1M), rc0(1M), rc2(1M). 

inittab(4) in the Programmer's Reference Manual. 
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NAME 

strace - print STREAMS trace messages 

SYNOPSIS 

strace [ mid sid level ] ... 

DESCRIPTION 

Strace without arguments writes all STREAMS event trace 
messages from all drivers and modules to its standard output. 
These messages are obtained from the STREAMS log driver 
[log {7)]. If arguments are provided they must be in triplets of 
the form mid, sid, level, where mid is a STREAMS module ID 
number, sid is a sub-ID number, and level is a tracing priority 
level. Each triplet indicates that tracing messages are to be 
received from the given module/driver, sub-ID (usually indicat- 
ing minor device), and priority level equal to or less than the 
given level. The token all may be used for any member to 
indicate no restriction for that attribute. 

The format of each trace message output is; 

<seq> <time> < ticks > < level > < flags > <mid> <sid> 
< text > 

< seq > Trace sequence number. 

< time > Time of message in hh:mm:ss. 

< ticks > Time of message in machine ticks since boot. 

< level > Tracing priority level. 

< flags > E : message is also in the error log. 

F : indicates a fatal error. 
N : mail was sent to the system administra- 
tor. 

< mid > Module ID number of source. 
<sid> Sub-ID number of source. 

< text > Formatted text of the trace message. 

Once initiated, strace will continue to execute until terminated 
by the user. 

EXAMPLES 

Output all trace messages from the module or driver whose 
module ID is 41: 
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strace 41 all all 

Output those trace messages from driver/module ID 41 with 
sub-IDs 0, 1 , or 2: 

strace 41 0 1 41 1 1 41 2 0 

Messages from sub-IDs 0 and 1 must have a tracing level less 
than or equal to 1 . Those from sub-ID 2 must have a tracing 
level of 0. 

CAVEATS 

Due to performance considerations, only one strace process is 
permitted to open the STREAMS log driver at a time. The log 
driver has a list of the triplets specified in the command invo- 
cation, and compares each potential trace message against 
this list to decide if it should be formatted and sent up to the 
strace process. Hence, long lists of triplets will have a greater 
impact on overall STREAMS performance, Running strace will 
have the most impact on the timing of the modules and 
drivers generating the trace messages that are sent to the 
strace process. If trace messages are generated faster than 
the strace process can handle them, then some of the mes- 
sages will be lost. This last case can be determined by exa- 
mining the sequence numbers on the trace messages output. 

SEE ALSO 

iog(7). 

System V Operating System STREAMS Programmer's Guide. 
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NAME 

strclean - STREAMS error logger cleanup program 

SYNOPSIS 

strclean [ -d logdir ] [ -a age ] 

DESCRIPTION 

Strclean is used to clean up the STREAMS error logger direc- 
tory on a regular basis [for example, by using cron (1M)]. By 
default, all files with names matching error.* in 
/usr/adm/streams that have not been modified in the last 3 
days are removed. A directory other than /usr/adm/streams 
can be specified using the -d option. The maximum age in 
days for a log file can be changed using the -a option. 

EXAMPLE 

strclean -d /usr/adra/streams -a 3 

has the same result as running strclean with no arguments. 
NOTES 

Strclean is typically run from cron (1M) on a daily or weekly 
basis. 

FILES 

/usr/adm/streams/error.* 

SEE ALSO 

cron(lM), strerr(1M). 

System V Operating System STREAMS Programmer's Guide. 
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NAME 

strerr - STREAMS error logger daemon 

SYNOPSIS 
strerr 

DESCRIPTION 

Strerr receives error log messages from the STREAMS log 
driver [log (7)] and appends them to a log file. The error log 
files produced reside in the directory /usr/adm/streams, and 
are named error. mm~dd, where mm is the month and dd is 
the day of the messages contained in each log file. 

The format of an error log message is: 

<seq> <time> < ticks > < flags > <mid> <sid> <text> 

< seq > Error sequence number. 
<time> Time of message in hh: mm: ss. 

< ticks > Time of message in machine ticks since boot 

priority level. 

< flags > T : the message was also sent to a tracing 

process. 

F : indicates a fatal error. 

N : send mail to the system administrator. 

< mid > Module ID number of source. 

< sid > Sub-ID number of source. 

<text > Formatted text of the error message. 

Messages that appear in the error log are intended to report 
exceptional conditions that require the attention of the system 
administrator. These messages which indicate the total failure 
of a STREAMS driver or module should have the F flag set. 
Those messages requiring the immediate attention of the 
administrator will have the N flag set, which causes the error 
logger to send the message to the system administrator via 
ma//(l). 

The priority level usually has no meaning in the error log but 
will have meaning if the message is also sent to a tracer pro- 
cess. 
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Once initiated, strerr will continue to execute until terminated 
by the user. Commonly, strerr would be executed asynchro- 
nously. 

CAVEATS 

Only one strerr process at a time is permitted to open the 
STREAMS log driver. 

If a module or driver is generating a large number of error 
messages, running the error logger will cause a degradation in 
STREAMS performance. If a large burst of messages is gen- 
erated in a short time, the log driver may not be able to 
deliver some of the messages. This situation is indicated by 
gaps in the sequence numbering of the messages in the log 
files. 

FILES 

/usr/adm/streams/error.mm-c/of 
SEE ALSO 

log(7). 

System V Operating System STREAMS Programmer's Guide. 
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NAME 

su - become super-user or another user 

SYNOPSIS 

su [ - ] I name [ arg ... ] ] 

DESCRIPTION 

Su allows one to become another user without logging off. 
The default user name is root (that is to say, super-user). 

To use su, the appropriate password must be supplied (unless 
one is already root). If the password is correct, su will exe- 
cute a new shell with the real and effective user ID set to that 
of the specified user. The new shell will be the optional pro- 
gram named in the shell field of the specified user's password 
file entry [see passwd(4)), or /bin/sh if none is specified [see 
sr»(1)]. To restore normal user ID privileges, type an EOF 
{cntrl-d) to the new shell. 

Any additional arguments given on the command line are 
passed to the program invoked as the shell. When using pro- 
grams like sn(1), an arg of the form -c string executes string 
via the shell and an arg of -r will give the user a restricted 
shell. When additional arguments are passed, /bin/sh Is 
always used. When no additional arguments are passed, su 
uses the shell specified in the password file. 

The following statements are true only if the optional program 
named in the shell field of the specified user's password file 
entry is like sh(1). If the first argument to su is a -, the 
environment will be changed to what would be expected if the 
user actually logged in as the specified user. This is done by 
invoking the program used as the shell with an argO value 
whose first character is thus causing first the system's pro- 
file (/etc/ profile) and then the specified user's profile (.profile 
in the new HOME directory) to be executed. Otherwise, the 
environment is passed along with the possible exception of 
$PATH, which is set to /bin:/etc:/usr/bin for root. Note that if 
the optional program used as the shell is /bin/sh, the user's 
.profile can check argO for -sh or -su to determine if it was 
invoked by /og/n(1) or su(1), respectively. If the user's pro- 
gram is other than /bin/sh, then .profile is invoked with an 
argO of -program by both login (1) and su(1). 
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All attempts to become another user using su are logged in 
the log file /usr/adm/sulog. 

EXAMPLES 

To become user bin while retaining your previously exported 
environment, execute: 



To become user bin but change the environment to what 
would be expected if bin had originally logged in, execute: 

su - bin 

To execute command with the temporary environment and 
permissions of user bin, type: 

su - bin -c "command args" 



SEE ALSO 

env(1), login{1), sh(1) in the User's Reference Manual. 
passwd(4), profile(4), environ(5) in the Programmer's Refer- 
ence Manual. 



su bin 



FILES 



/etc/passwd 
/etc/profile 
$HOME/.profile 
/usr/adm/sulog 



system's password file 
system's profile 
user's profile 
log file 



Page 2 



UP-13529 



SWAP(IM) 



NAME 

swap - swap administrative interface 
SYNOPSIS 

/etc/swap -a swapdev [ swaplow [ swaplen ] ] 
/etc/swap -d swapdev [ swaplow ] 
/etc/swap -I 
DESCRIPTION 

Swap provides a method of adding, deleting, and monitoring 
the system swap areas used by the memory manager. The 
following options are recognized: 

-a Add the specified swap area. Swapdev is the name of the 
block special device, for example, /dev/dsk/c0d0s2. 
Swaplow is the offset in 512-byte blocks into the device 
where the swap area should begin. Swaplen is the length 
of the swap area in 512-byte blocks. If swaplen is miss- 
ing, the remainder of the partition (from swaplow to the 
end of the pariition) is assumed. If both swaplow and 
swaplen are missing, the entire partition is assumed (that 
is, swaplow is assumed to be block 0). This option can 
only be used by the super-user. 

-d Delete the specified swap area. Swapdev is the name of 
block special device, for example, /dev/dsk/cGd0s2. 
Swaplow is the offset in 512-byte blocks into the device 
where the swap area should begin. If swaplow is missing, 
it is assumed to be block 0. Using this option marks the 
swap area as "INDEL* (in process of being deleted). The 
system will not allocate any new blocks from the area, 
and will try to free swap blocks from it. The area will 
remain in use until all blocks from it are freed. This option 
can only be used by the super-user. 

-I List the status of all the swap areas. The output has four 
columns: 
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DEV 

The swapdev special file for the swap area if one can 
be found in the /dev/dsk or /dev directories, and its 
major/minor device number in decimal. 

LOW 

The swaplow value for the area in 512-byte blocks. 

LEN 

The swaplen value for the area in 512-byte blocks. 
FREE 

The number of free 512-byte blocks in the area. If 
the swap area is being deleted, this column will be 
marked INDEL, 

WARNINGS 

No check is done to see if a swap area being added overlaps 
with an existing swap area or file system. 
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NAME 

sync - update the super block 

SYNOPSIS 
sync 

DESCRIPTION 

Sync executes the sync system primitive. If the system is to 
be stopped, sync must be called to insure file system integrity, 
It will flush all previously unwritten system buffers out to disk, 
thus assuring that all file modifications up to that point will be 
saved. See sync{2) for details. 

NOTE 

If you have done a write to a file on a remote machine in a 
Remote File Sharing environment, you cannot use sync to 
force buffers to be written out to disk on the remote machine. 
Sync will only write local buffers to local disks. 

SEE ALSO 

sync(2) in the Programmer's Reference Manual. 
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NAME 

sysadm - menu interface to do system administration 

SYNOPSIS 

sysadm [ sub-command ] 

DESCRIPTION 

This command, when invoked without an argument, presents a 
menu of system administration subcommands, from which 
the user selects. If the optionai argument is presented, the 
named sub-command is run or the named sub-menu is 
presented. 

The sysaofm command may be given a password. See 
admpasswd in the Subcommands section. 

Subcommands 

The following menus of subcommands are available. The 
number of bullets ( * ) in front of each item indicates the level 
of the menu or subcommand. 

• diskmgmt 

Hard disk management menu. 

The subcommands in this menu provide functions for 
using hard disks. The subcommands include the ability to 
check the file system, copy disks, format disks, make file 
systems, and mount and unmount disk file systems. 

• • checkfsys 

Check and repair file systems on hard disk. 

Checkfsys checks a file system on a hard disk for errors, 
if there are errors, this procedure attempts to repair them. 

• * cpdisk 

Make copies of one portion of a hard disk. 

This procedure makes a copy of the content of a speci- 
fied portion of a hard disk to another hard disk. 

• • display 

Display hard disk partitioning. 

Display allows the user to display the hard disk partition- 
ing. This informs the user of current disk partitioning 
information. 
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• • format 

Format hard disk. 

This command prepares a new hard disk for use. It 
requires a description file for the type of hard disk that 
you want to format. Formatting removes all existing data 
from the disk, effectively erasing it. 

• • makefsys 

Create a new file system on a hard disk. 

Makefsys creates a new file system on a hard disk. After 
constructing the file system, the user can mount it to an 
existing directory for use. 

• • mountfsys 

Mount a file system. 

Mountfsys mounts a file system to an existing directory. 
Mountfsys announces to the system that a block special 
device is available to the user from the mount point direc- 
tory. This directory must already exist; it becomes the 
name of the root of the newly mounted file system. 

• • umountfsys 

Unmount a file system. 

Umountfsys unmounts a file system which was previously 
mounted. 

• filemgmt 

File management menu. 

The subcommandsjn this menu allow the user to protect 
files on the hard disk file systems by copying them onto 
diskettes and later restoring them to the hard disk by 
copying them back. 
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Subcommands are also provided to determine which files 
might be best kept on diskette based on age or size. 

• > backup 

Back up files from integral hard disk to removable disk or 
tape. 

Backup saves copies of files from the integral hard disk 
file systems to removable disk or tape. There are two 
kinds of backups: 

COMPLETE - copies all files (useful in case of serious file 
system damage). 

INCREMENTAL - copies files changed since the last 
backup. 

The normal usage is to do a complete backup of each file 
system and then periodically do incremental backups. 
Two cycles are recommended (one set of complete back- 
ups and several incrementals to each cycle). Files backed 
up with backup are restored using restore. 

• ■ bupsched 

Backup reminder scheduling menu. 

Backup scheduling is used to schedule backup reminder 
messages and backup reminder checks. Backup rem- 
inder messages are sent to the console to remind the 
administrator to back up particular file systems when the 
machine is shut down or a reminder check has been run 
during the specified time period. 

Backup reminder checks specify particular times at which 
the system checks to see if any backup reminder mes- 
sages have been scheduled. 
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• schedcheck 

Schedule backup reminder checks. 

Backup reminder checks are run at specific times to 
check to see if any reminders are scheduled. The user 
specifies the times at which the check is to be run. 
Checks are run for the reminder messages scheduied by 
schedmsg. 

• schedmsg 

Schedule backup reminder message. 

Backup reminder messages are sent to the console if the 
machine is shut down or a reminder check has been 
scheduled. The user specifies the times at which it is 
appropriate to send a message and the file systems to be 
included in the message. 

diskuse 

Display how much of the hard disk is being used. 

Diskuse lets the user know what percentage of the hard 
disk is currently occupied by files. The list is organized by 
file system names. 

fileage 

List files older than a particular date. 

Fileage prints the names of alf files older than the date 
specified by the user. If no date is entered, all files older 
than 90 days are listed. If no directory is specified to look 
in, the /usr/admin directory is used. 

• fiiesize 

List the largest files in a particular directory. 

Fiiesize prints the names of the largest files in a specific 
directory. If no directory is specified, the /usr/admin 
directory is used. If the user does not specify how many 
large files to list, 10 files are listed. 
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• • restore 

Restore files from backup and store media to integral 
hard disk. 

Restore copies files from disks and tapes made by 
backup and store back onto the hard disk. You can 
restore individual files, directories of files, or the entire 
contents of a disk or tape. The user can restore from 
both "incremental" and "complete" media. The user can 
also list the names of files stored on the disk or tape. 

• « store 

Store files and directories of files onto disk or tape. 

Store copies files from the integral hard disk to disk or 
tape and optionally allows the user to verify that they 
worked and remove them when done. Typically, these 
would be files that the user wants to archive or restrict 
access to. The user can store single files and directories 
of files. Use the restore command to put stored files 
back on the integral hard disk and to list the files stored. 

• machinemgmt 

Machine management menu. 

Machine management functions are tools used to operate 
the machine; for example, turn it off or reboot. 

• » whoson 

Print list of users currently logged onto the system. 

Whoson prints the login ID, terminal device number, and 
sign-on time of all users who are currently using the com- 
puter. 

• packagemgmt 

Package management. 

These submenus and subcommands manage various 
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software and hardware packages that you install on your 
machine. Not all optional packages add subcommands 
here. 

• softwaremgmt 

Software management menu. 

These subcommands permit the user to install new 
software, remove software, and run software directly from 
the removable disk it is delivered on. The removekpg and 
runpkg capabilities are dependent on the particular 
software packages. See the instructions delivered with 
each package. 

• • install pkg 

Install new software package onto integral hard disk. 

Install copies fifes from removable disk onto the integral 
hard disk and performs additional work if necessary so 
that the software can be run. From then on, the user will 
have access to those commands. 

• - Ustpkg 

List packages already installed. 

This subcommand show you a list of currently installed 
optional software packages. 

• • removepkg 

Remove previously installed package from integral hard 
disk. 

This subcommand displays a list of currently installed 
optional software packages. Actions necessary to remove 
the software packages specified by the user will then be 
performed. The removable disk used to installpkg the 
software is needed to remove it. 

• • runpkg 

Run software package without installing it. 

This package allows the user to run software from a 
removable disk without installing it permanently on the 
system. This is useful if the user does not use the 
software often or does not have enough room on the sys- 
tem. WARNING: not all software packages have the abil- 
ity to run their contents this way. See the instructions 
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that come with the software package. 

• syssetup 

System setup menu. 

System setup routines allow the user to tell the computer 
what its environment looks like: what the date, time, and 
time zone are, what administration and system capabilities 
are to be under password control, what the machine's 
name is, and so forth. The first-time setup sequence is 
also here. 

• • admpasswd 

Assign or change administrative passwords. 

Admpasswd lets you set or make changes to passwords 
for administrative commands and logins such as setup 
and sysadm. 

• • datettme 

Set the date, time, time zone, and daylight savings time. 

Datetime tells the computer the date, time, time zone, 
and whether you observe Daylight Savings Time (DST), It 
is normally run once when the machine is first set up. If 
you observe DST, the computer will automatically start to 
observe it in the spring and return to Standard Time in 
the fall. The machine has to be turned off and turned 
back on again to guarantee that all times are reported 
correctly. Most are correct the next time the user logs in. 

• • nodename 

Set the node name of this machine. 

This command allows you to change the node name of 
this machine. The node name is used by various com- 
munications networks to identify this machine. 

• * setup 

Set up your machine the very first time. 

Setup allows the user to define the first login, to set the 
passwords on the user-definable administration logins, 
and to set the time zone for your location. 

• * syspasswd 

Assign system passwords. 
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Syspasswd lets the user set system passwords normally 
reserved for the very knowledgeable user. For this rea- 
son, this procedure may assign those passwords, but may 
not change or clear them. Once set, they may only be 
changed by the specific login or the "root" login. 

• ttymgmt 

Terminal management. 

This procedure allows the user to manage the computer's 
terminal functions. 

• • lineset 

Show tty line settings and hunt sequences. 

The tty line settings are often hunt sequences where, if 
the first line setting does not work, the line "hunts" to the 
next line setting until one that does work comes by. This 
subcommand shows the various sequences with only 
specific line settings in them. It also shows each line set- 
ting in detail. 

• • mklineset 

Create new tyy line settings and hunt sequences. 

This subcommand helps you to create tty line setting 
entries. You might want to add line settings that are not 
in the current set or create hunt sequences with only 
specific line settings in them. The created hunt 
sequences are circular; stepping past the last setting puts 
you on the first. 

■ * modtty 

Show and optionally modify characteristics of tty lines. 

This subcommand reports and allows you to change the 
characteristics of tty lines (also called "ports"). 

• usermgmt 

User management menu. 

These subcommands allow you to add, modify and delete 
the list of users that have access to your machine. You 
can also place them in separate groups so that they can 
share access to files within the group but protect them- 
selves from other groups. 
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• • addgroup 

Add a group to the system. 

Addgroup adds a new group name or ID to the computer. 
Group names and IDs are used to identify groups of 
users who desire common access to a set of files and 
directories. 

• • adduser 

Add a user to the system. 

Adduser installs a new login ID on the machine. You are 
asked a series of questions about the user and then the 
new entry is made. You can enter more than one user at 
a time. Once this procedure is finished, the new login ID 
is available. 

• • deigroup 

Delete a group from the system. 

Deigroup allows you to remove groups from the com- 
puter. The deleted group is no longer identified by name. 
However, files may still be identified with the group ID 
number. 

• • deluser 

Delete a user from the system. 

Deluser allows you to remove users from the computer. 
The deleted user's files are removed from the hard disk 
and their logins are removed from the /etc/passwd file. 

• • Isgroup 

List groups in the system. 

Lsgroup lists all the groups that have been entered into 
the computer. This list is updated automatically by add- 
group and deigroup. 

• • Isuser 

List users in the system. Lsuser lists all the users that 
have been entered into the computer. This list is updated 
automatically by adduser and deluser. 

• • modadduser 

Modify defaults used by adduser. 

Modadduser allows the user to change some of the 
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defaults used when adduser creates a new login. Chang- 
ing the defaults does not effect any existing logins, only 
logins made from this point on. 

• • modgroup 

Make changes to a group on the system. 

Modgroup allows the user to change the name of a 
group that the user enters when addgroup is run to set 
up new groups. 

• • moduser 

Menu of commands to modify a user's login. 

This menu contains commands that modify the various 
aspects of a user's login. 

• • • chgfoginid 

Change a user's login ID. 

This procedure allows the user to change a user's login 
ID. Administrative and system logins cannot be changed. 

• • * chgpasswd 

Change a user's password. 

This proceudure allows removal or change of a user's 
password. Administrative and system login passwords 
cannot be changed. To change administrative and sys- 
tem login passwords, see the system setup menu: 
sysadm syssetup. 

• • * chgshell 

Change a user's login shell. 

This procedure allows the user to change the command 
run when a user logs in. The login shell of the administra- 
tive and system logins cannot be changed by this pro- 
cedure. 

FILES 

The files that support sysadm are found in /usr/admin. 
The menu starts in directory /usr/admin/menu. 
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NAME 

sysdef - output system definition 

SYNOPSIS 

/etc/sysdef [ systemjiameiist [ master ] ] 

DESCRIPTION 

Sysdef outputs the current system definition in tabular form. 
It lists all hardware devices as well as pseudo devices, system 
devices, and the values of all tunable parameters. It gen- 
erates the output by analyzing the named operating system 
file [systemjiameiist) and extracting the configuration infor- 
mation from the name list itself. 

FILES 

/unix default operating system file (where the 

system namelist is) 

/etc/master default master file 

SEE ALSO 

nlist(3C), master(4) in the Programmer's Reference Manual. 

DIAGNOSTICS 

internal name list overflow 

if the master table contains more than an internally speci- 
fied number of entries for use by nlist (3C). 

WARNING 

Sysdef displays information about configured devices only, not 
loaded devices. Use tddrvtfM) to obtain information about 
loaded device drivers. 
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NAME 

tic - terminfo compiler 

SYNOPSIS 

tic [ -v [ n ] ] [ -c ] file 

DESCRIPTION 

Tic translates a terminfo (4) file from the source format into the 
compiled format. The results are placed in the directory 
/usr/lib/terminfo. The compiled format is necessary for use 
with the library routines described in curses (3X), 

•vn (verbose) Output to standard error trace information 
showing tic'sprogress. The optional integer n is a 
number from 1 to 10, inclusive, indicating the desired 
level of detail of information. If n is omitted, the 
default level is 1. If r? is specified and greater than 1, 
the level of detail is increased. 

-c Only check file for errors. Errors in use= links are 
not detected. 

file Contains one or more terminfo (4) terminal descrip- 
tions in source format [see terminfo (4)). Each 
description in the file describes the capabilities of a 
particular terminal. When a use -entry- name field is 
discovered in a terminal entry currently being com- 
piled, tic reads in the binary from /usr/lib/terminfo to 
complete the entry, (Entries created from file will be 
used first. If the environment variable TERMINFO is 
set, that directory is searched instead of 
/usr/lib/terminfo.) Tic duplicates the capabilities in 
entry-name for the current entry, with the exception 
of those capabilities that explicitly are defined in the 
current entry. 

If the environment variable TERMINFO is set, the compiled 
results are placed there instead of /usr/lib/terminfo. 

FILES 

/usr/lib/terminfo/?/* compiled terminal description data 

base 

SEE ALSO 

curses(3X), term (4), terminfo (4) in the Programmer's Refer- 
ence Manual. 
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"curses/terminfo" in the System V Operating System 
Programmer's Guide. 

WARNINGS 

Total compiled entries cannot exceed 4096 bytes. The name 
field cannot exceed 128 bytes. 

Terminal names exceeding 14 characters will be truncated to 
14 characters and a warning message will be printed. 

When the -c option is used, duplicate terminal names will not 
be diagnosed; however, when -c is not used, they will be. 

BUGS 

To allow existing executables from UNIX System V Release 2 
to run with the compiled terminfo entries created by the new 
terminfo compiler, cancelled capabilities will not be marked as 
cancelled within the terminfo binary unless the entry name has 
a ' + ' within it. (Such terminal names are only used for inclu- 
sion within other entries via a use= entry. Such names would 
not be used for real terminal names.) 

For example: 

W15+nl , kf 1«, kf 28, .... 

M15+base, kf1*\E0c, kf2=\EOd, 

4<H5-n!J*«l5 terminal without keys, 
use=W15+nl , use=W15+base, 

The above example works as expected; the definitions for the 
keys do not show up in the 4415-nl entry. However, if the 
entry 4415 + nl did not have a plus sign within its name, the 
cancellations would not be marked within the compiled file and 
the definitions for the function keys would not be cancelled 
within 4415-nl. 
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DIAGNOSTICS 

Most diagnostic messages produced by tic during the compi- 
lation of the source file are preceded with the approximate line 
number and the name of the terminal currently being worked 
on. 

mkdir . . . returned bad status 

The named directory could not be created, 

File does not start with terminal names in column one 

The first thing seen in the file, after comments, must be 
the list of terminal names. 

Token after a seek(2) not NAMES 

Somehow the file being compiled changed during the 
compilation. 

Not enough memory for usejist element 
or 

Out of memory 

Not enough free memory was available {malloc (3C) 
failed). 

Can't open . . . 

The named file could not be created. 

Error in writing . . . 

The named file could not be written to. 

Can't link,., to ... 
A link failed. 

Error in re-reading compiled file . . . 

The compiled file could not be read back in. 

Premature EOF 

The current entry ended prematurely. 

Backspaced off beginning of line 

This error indicates something wrong happened within tic. 

Unknown Capability - ". . ." 

The named invalid capability was found within the file. 

Wrong type used for capability ". . ." 

For example, a string capability was given a numeric 
value. 
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Unknown token type 

Tokens must be followed by '<§>' to cancel, 7 for boole- 
ans, '#' for numbers, or '=' for strings. 

, .": bad term name 
or 

Line . . . : Illegal terminal name - . ," 

Terminal names must start with a letter or digit 

The given name was invalid. Names must not contain 
white space or slashes, and must begin with a letter or 
digit. 

. .": terminal name too long. 
An extremely long terminal name was found. 

. .": terminal name too short. 
A one-letter name was found. 

". . ." filename too long, truncating to ". . 

The given name was truncated to 14 characters due to 
System V file name length limitations. 

". . ." defined in more than one entry. Entry being used 
is 

An entry was found more than once. 

Terminal name ". . ." synonymf or itself . 

A name was listed twice in the list of synonyms. 

At least one synonym should begin with a fetter. 

At least one of the names of the terminal should begin 
with a letter. 

Illegal character - ". . 

The given invalid character was found in the input file. 

Newline in middle of terminal name 

The trailing comma was probably left off of the list of 
names. 

Missing comma 

A comma was missing. 

Missing numeric value 

The number was missing after a numeric capability. 

NULL string value 

The proper way to say that a string capability does not 
exist is to cancel it. 



Page 4 



UP-13529 



TIC(IM) 



Very long string found. Missing comma? 
Self-explanatory. 

Unknown option. Usage is: 

An invalid option was entered. 

Too many file names. Usage is: 
Self-explanatory. 

". . ." non-existant or permission denied 

The given directory could not be written into. 

*. . ." is not a directory 
Self-explanatory. 

M . . .": Permission denied 
Access denied. 

, ."; Not a directory 

tic wanted to use the given name as a directory, but it 
already exists as a file. 

SYSTEM ERROR!! Fork failed!!! 
A fork (2) failed. 

Error in following up use-links. Either there is a loop 
in the links or they reference non-existent terminals. 
The following is a list of the entries involved: 

A terminfo{A) entry with a use = name capability either 
referenced a non-existant terminal called name or name 
somehow referred back to the given entry. 



UP-13529 



Page 5 



TIC(IM) 



[This page left blank.] 



Page 6 



UP-13529 



TSI)BADM(IM) 



NAME 

tsdbadm - Remote Terminal service database administration 

SYNOPSIS 
tsdbadm 

DESCRIPTION 

Tsdbadm is a menu-driven administration toot used to modify 
the Remote Terminal service database (/usr/net/ 
adm/cfg/ttysrv.db). Using tsdbadm, you can: 

• Change the default service 

• Delete a service 

• Add a new service 

• Modify an existing service 

• List available services. 

This database is used when a Remote Terminal service con- 
nection is established over an RFS network, for example, by 
using cu (1C) or uucp (1C). When an attempt is made to con- 
nect, the Remote Terminal service looks up the available ser- 
vices in the terminal service database. 

If only a single service is available, that service is automatically 
executed. If the Remote Terminal service database contains 
more than one service, the caller is prompted to specify the 
terminal service to be executed. 

Each entry in the Remote Terminal service database has three 
fields: Name, Description, and Command Line, 

where 

Name 

is the name of the service. This name must be unique, a 
single word, and no more than 14 characters. 

Description 

is a brief description of the service. The description is lim- 
ited to a single line, no more than 60 characters. 

Command Line 

is the command line to be executed when this service is 
selected. This can be a full command line with options 
and arguments. 
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FILES 

/usr/net/adm/cfg/ttysrv.db 

SEE ALSO 

tslimit(lM). 
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NAME 

tslimit - Remote Terminal service limits administration 
SYNOPSIS 

tslimit [ -? ] [ -c count ] [ -m max_count ) [ -r] 
DESCRIPTION 

Tslimit is used to display or update the current count and 
maximum allowed number of remote terminal servers. When 
used with no options, tslimit sets the maximum allowed 
number of remote terminal servers to a default value of 16. 
and leaves the current count unchanged. 

This limit applies to Remote Terminal connections established 
over an RFS network, for example by using cu(1C) or 
uucp (1C) . 

The following options are recognized: 

-? displays a brief description of the command. 

-c count 

changes the current count of remote terminal servers to 
count . This option is needed only when the count is out 
of sync with the actual number of remote terminal servers 
running. This count is automatically incremented and 
decremented by the Remote Terminal service, and does 
not normally need to be modified. 

-m max_count 

changes the maximum number of remote terminal servers 
to maxjcount, limiting the number of connections that can 
be made from other machines using the Remote Terminal 
service. 

-r retrieves the current values of count and maxjcount, and 
prints them to standard out. 

The current counf and max_count values are stored in a limits 
file (/usr/net/adm/cfg/ttysrv.pl). If the limits file doesn't exist, 
tslimit creates it. When the limits file is not present, no limit is 
imposed on the number of remote terminal connections. 

ERRORS 

An error message is printed to standard error if one of the fol- 
lowing is true: 
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• The limits file is currently being edited or referenced (lock 
file exists for the file). 

• You lack the prvileges needed to edit the limits file. 

• The number of remote terminal server processes currently 
running exceeds the new maximum limit. 

FILES 

/usr/net/adm/cf g/ttysrv. pi 
/usr/net/adm/tmp/ttysrv.cp 

SEE ALSO 

tsdbadm(IM). 
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NAME 

uadmin - administrative control 

SYNOPSIS 

/etc/uadmin cmd fen 

DESCRIPTION 

The uadmin command provides control for basic administra- 
tive functions. This command is tightly coupled to the System 
Administration procedures and is not intended for general use. 
It may be invoked only by the super-user. 

The arguments cmd (command) and fen (function) are con- 
verted to integers and passed to the uadmin system call, 

SEE ALSO 

uadmin(2) in the Programmer's Reference Manual. 
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NAME 

unadv - unadvertise a Remote File Sharing resource 

SYNOPSIS 

unadv resource 

DESCRIPTION 

Unadv unadvertises a Remote File Sharing resource, which is 
the advertised symbolic name of a local directory, by remov- 
ing it from the advertised information on the domain name 
server. Unadv prevents subsequent remote mounts of that 
resource. It does not affect continued access through existing 
remote or local mounts. 

An administrator at a server can unadvertise only those 
resources that physically reside on the local machine. A 
domain administrator can unadvertise any resource in the 
domain from the primary name server by specifying resource 
name as domain.resource. (A domain administrator should 
only unadvertise another hosts resources to clean up the 
domain advertise table when that host goes down. Unad- 
vertising another host's resource changes the domain adver- 
tise table, but not the host advertise table.) 

This command is restricted to the super-user. 

ERRORS 

If resource is not found in the advertised information, an error 
message will be sent to standard error. 

SEE ALSO 

adv(1M), fumount(IM), nsquery(IM). 
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NAME 

uucheck - check the uucp directories and permissions file 
SYNOPSIS 

/usr/lib/uucp/uucheck [ -v ] [ -x debugjevel ] 
DESCRIPTION 

uucheck checks for the presence of the uucp system required 
files and directories. Within the uucp makefile, it is executed 
before the installation takes place. It also checks for some 
obvious errors in the Permissions file 
(/usr/lib/uucp/Permissions). When executed with the -v 
option, it gives a detailed explanation of how the uucp pro- 
grams will interpret the Permissions file. The -x option is used 
for debugging. Debug-option is a single digit in the range 1-9; 
the higher the value, the greater the detail. 

Note that uucheck can only be used by the super-user or 
uucp, 

FILES 

/usr/lib/uucp/Systems 

/usr/lib/uucp/Permissions 

/usr/lib/uucp/Devices 

/usr/lib/uucp/Maxuuscheds 

/usr/lib/uucp/Maxuuxqts 

/usr/spool/uucp/* 

/usr/spool/locks/LCK* 

/usr/spool/uucppublic/* 

SEE ALSO 

uucico(1M), uusched(IM). 

uucp(1C), uustat(lC), uux(1C) in the User's Reference 
Manual. 

BUGS 

The program does not check file/directory modes or some 
errors in the Permissions file such as duplicate login or 
machine name. 
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NAME 

uucico - file transport program for the uucp system 
SYNOPSIS 

/usr/lib/uucp/uucico [ -r rolejiumber ] [ -x debugjevel ] 
[ -1 interface j [ -d spool_directory ] «s systemjiame 

DESCRIPTION 

Uucico is the file transport program for uucp work file 
transfers. Role numbers for the -r are the digit 1 for master 
mode or 0 for slave mode (default). The -r option should be 
specified as the digit 1 for master mode when uuctco is 
started by a program or cron. Uux and uucp both queue jobs 
that will be transferred by uucico. It is normally started by the 
scheduler, uusched, but can be started manually; this is done 
for debugging. For example, the shell Uutry starts uucico with 
debugging turned on. A single digit must be used for the -x 
option with higher numbers for more debugging. 

The -i option defines the interface used with uucico. This 
interface only affects slave mode. Known interfaces are UNIX 
(default), TLI (basic Transport Layer Interface), and TUS (Tran- 
sport Layer Interface with Streams modules, read/write). 

FILES 

/usr/lib/uucp/Systems 

/usr/lib/uucp/Permissions 

/usr/lib/uucp/Devices 

/usr/lib/uucp/Devconfig 

/usr/lib/uucp/Sysfiles 

/usr/lib/uucp/Maxuuxqts 

/usr/lib/uucp/Maxuuscheds 

/usr/spool/uucp/* 

/usr/spool/locks/LCK* 

/usr/spool/uucppublic/* 

SEE ALSO 

cron(lM), uusched(lM), uutry(1M). 

uucp(lC), uustat(lC), uux(1C) in the User's Reference 
Manual. 
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NAME 

uucleanup - uucp spool directory clean-up 
SYNOPSIS 

/usr/lib/uucp/uucleanup [ -Cf/me ] [ -Wf/me ] [ -Xf/'me ] 
[ -mstring ] [ -of/me ] [ -ssystem j 

DESCRIPTION 

Uucleanup will scan the spool directories for old files and take 
appropriate action to remove them in a useful way: 

• Inform the requestor of send/receive requests for systems 
that can not be reached. 

• Return mail which cannot be delivered to the sender. 

• Delete or execute rnews for rnews type files (depending 
on where the news originated -locally or remotely). 

• Remove alt other files. 

In addition, there is provision to warn users of requests that 
have been waiting for a given number of days (default 1). 
Note that uucleanup will process as if all option times were 
specified to the default values unless time is specifically set. 

The following options are available. 

-Cr/me Any C. files greater or equal to time days old will 
be removed with appropriate information to the 
requestor, (default 7 days) 

-DrVme Any D. files greater or equal to time days old will be 
removed. An attempt will be made to deliver mail 
messages and execute rnews when appropriate 
(default 7 days). 

-Wf/me Any C. files equal to time days old will cause a mail 
message to be sent to the requestor warning about 
the delay in contacting the remote. The message 
includes the JOBID, and in the case of mail, the 
mail message. The administrator may include a 
message line telling whom to call to check the 
problem (-m option) (default 1 day). 

-Xf/me Any X. files greater or equal to time days old will be 
removed. The D. files are probably not present (if 
they were, the X. could get executed). But if there 
are D. files, they will be taken care of by D. 
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processing (default 2 days). 

•mstring This line will be included in the warning message 
generated by the -W option. The default line is 
"See your local administrator to locate the prob- 
lem". 

-of/me Other files whose age is more than time days will 
be deleted (default 2 days). 

•ssysfem Execute for system spool directory only. 

•xc/ebugjeve/ 

The -x debug level is a single digit between 0 and 
9; higher numbers give more detailed debugging 
information. (If uucleanup was compiled with - 
DSM ALL, no debugging output will be available.) 

This program is typically started by the shell 
uudemon. cleanup, which should be started by cron (1M). 

FILES 

/usr/lib/uucp directory with commands used by 

uucleanup internally 

/usr/spool/uucp spool directory 

SEE ALSO 

cron(1M). 

uucp(lC), uux(1C) in the User's Reference Manual. 
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NAME 

uugetty - set terminal type, modes, speed, and line discipline 
SYNOPSIS 

/usr/lib/uucp/getty [ -h ] [ -t timeout ] [ -r ] 
line [ speed [ type [ linedisc } } ] 

/usr/lib/uucp/getty -c file 

DESCRIPTION 

Uugetty is identical to greffy(1M) but changes have been made 
to support using the line for uucico, cu, and cf; that is, the 
line can be used in both directions. The uugetty command will 
allow users to login, but if the line is free, uucico, cu, or ct 
commands can use it for dialing out. The implementation 
depends on the fact that uucico, cu, and ct create lock files 
when devices are used. When the open() returns (or the first 
character is read when -r option is used), the status of the 
lock file indicates whether the line is being used by uucico, cu, 
ct, or someone trying to login. Note that in the -r case, 
several < car riage- return > characters may be required before 
the login message is output. The human users will be able to 
handle this slight inconvenience. Uucico trying to login will 
have to be told by using the following login script: 

HH \r\d\r\d\r\d\r in:-- in: ... 

where the . . . is whatever would normally be used for the login 
sequence. 

The following /etc/inittab entry can be used for an intelligent 
modem or a direct line: 

002:2:respawn:/usr/1 ib/uucp/uugetty -r -t 60 ttyOQ2 1200 

An entry for an intelligent modem or direct line that has a 
uugetty on each end must use the -r option. (This causes 
uugetty to wait to read a character before it puts out the login 
message, thus preventing two uugeffys from looping.) If there 
is a uugetty on one end of a direct line, there must be a 
uugetty on the other end as well. Here is an /etc/inittab entry 
using uugeffy on an intelligent modem or direct line: 

30 : 2 :respawn:/usr/l ib/uucp/uugetty -r -t 60 tty12 1200 

FILES 

/etc/gettydefs 
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/etc/issue 

SEE ALSO 

uucico(1M), getty(1M), init(1M), tty(7). 

ct(1C), cu(1C), login (1) in the User's Reference Manual, 

ioctl(2), gettydefs(4), inittab(4) in the Programmer's Reference 

Manual. 

BUGS 

Ct will not work when uugetty is used with an intelligent 
modem such as Penril or Ventel. 
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NAME 

uusched - the scheduler for the uucp file transport program 
SYNOPSIS 

/usr/lib/uucp/uusched [ -x debug level ] [ -u debugjevel 
1 

DESCRIPTION 

Uusched is the uucp file transport scheduler. It is usually 
started by the daemon uudemon.hour that is started by 
cron <1M) from an entry in /usr/spool/cron/crontabs: 

39 * * * * /bfn/su uucp -c *Vusr/l{b/uucp/uudemon.hour 
> /dev/null" 

The two options are for debugging purposes only; -x 
debugjevel will output debugging messages from uusched 
and -u debugjevel will be passed as -x debugjevel to 
uucico. The debugjevel is a number between 0 and 9; higher 
numbers give more detailed information. 

FILES 

/usr/lib/uucp/Systems 
/usr/lib/uucp/Permissions 
/usr/lib/uucp/Devices 
/usr/spool/uucp/* 
' /usr/spool/locks/LCK* 
/usr/spool/uucppublic/* 

SEE ALSO 

cron(1M), uucico(1M). 

uucp(lC), uustat(1C), uux(1C) in the User's Reference 
Manual. 
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NAME 

Uutry - try to contact remote system with debugging on 
SYNOPSIS 

/usr/lib/uucp/Uutry [ -x debugjevel ] [ -r ] system_name 
DESCRIPTION 

Uutry is a shell that is used to invoke uucico to call a remote 
site. Debugging is turned on (default is level 5); -x will over- 
ride that value. The -r overrides the retry time in 
/usr/spool/uucp/. status. The debugging output is put in file 
/tmp/systemjiame. A tail -f of the output is executed. A 
< DELETE > "or < BREAK > will give control back to the termi- 
nal while the uucico continues to run, putting its output in 
ftmp/system_name. 

FILES 

/usr/lib/uucp/Systems 

/usr/lib/uucp/Permissions 

/usr/lib/uucp/Devices 

/usr/lib/uucp/Maxuuxqts 

/usr/lib/uucp/Maxuuscheds 

/usr/spool/uucp/* 

/usr/spool/locks/LCK* 

/usr/spool/uucppublic/* 

/tmp/systern_name 

SEE ALSO 

uucico(1M), 

uucp(tC), uux(1C) in the User's Reference Manual. 
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NAME 

uuxqt - execute remote command requests 
SYNOPSIS 

/usr/lib/uucp/uuxqt [ -s system ] [ -x debugjevet ] 
DESCRIPTION 

Uuxqt is the program that executes remote job requests from 
remote systems generated by the use of the uux command. 
(Ma/7 uses uux for remote mail requests). Uuxqt searches the 
spool directories looking for X. files. For each X. file, uuxqt 
checks to see if all the required data files are available and 
accessible, and file commands are permitted for the request- 
ing system. The Permissions file is used to validate file acces- 
sibility and command execution permission. 

There are two environment variables that are set before the 
uuxqt command is executed: 

UUJVIACHINE is the machine that sent the job (the previous 
one). 

UIMJSER is the user that sent the job. 

These can be used in writing commands that remote systems 
can execute to provide information, auditing, or restrictions. 

The -x debug Jevel is a single digit between 0 and 9. Higher 
numbers give more detailed debugging information. 

FILES 

/usr/lib/uucp/Permissions 
/usr/lib/uucp/Maxuuxqts 
/usr/spool/uucp/* 
/usr/spool/locks/LCK* 

SEE ALSO 

uucico(lM). 

uucp(1C), uustat(tC), uux(1G), mail(1) in the User's Reference 
Manual. 



UP-13529 



Page 1 



UUXQT(IM) 



[This page left blank.] 



Page 2 



UP-13529 



VOLCOPY(IM) 



NAME 

volcopy - copy file systems with label checking 
SYNOPSIS 

/etc/votcopy [ options ] fsname special 1 volnamel special 
volname2 

DESCRIPTION 

Volcopy makes a literal copy of the file system using a block- 
size matched to the device. Options are: 

-a Invoke a verification sequence requiring a positive opera- 
tor response instead of the standard 10-second delay 
before the copy is made. 

-s (default) Invoke the DEL If wrong verification sequence. 

-to The output file is a disk section (also called slice or parti- 
tion), but is to be treated like a tape. 

-ti The input file is a disk section, but is to be treated like a 
tape. 

Other options are used only with tapes: 

-bpidensity Bits-per-inch (specifically, 800/1600/6250), 

-feetsize Size of reel in feet (specifically, 1200/2400), 

-reelnum Beginning reel number for a restarted copy, 

-buf Use double buffered I/O. 

-Q Use -bpi and -feet values appropriate for 

quarter-inch tape cartridge. 

If -ti or -to is specified, the "reel" capacity is simply the size of 
the disk section; the "reel" is assumed to be on a removable 
disk, such as a floppy. 

For a true tape such as half-inch reel- to- reel or quarter- inch 
cartridge, capacity is derived from tape length and density. 
The program requests length and density information if it is 
not given on the command line or is not recorded on an input 
tape label. If the file system is too large to fit on one reel, vol- 
copy will prompt for additional reels. Labels of all reels are 
checked. Tapes may be mounted alternately on two or more 
drives. If volcopy is interrupted, it will ask if the user wants to 
quit or wants a shell. In the latter case, the user can perform 
other operations [such as labelit (1M)] and return to volcopy 
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by exiting the new shell. 

The fsname argument represents the mounted name (for 
example, root, u1) of the file system being copied. Use the 
/aoe//f(1M) command to display the fsname of a file system 
for use with vo/copy, or to assign a name to a file system if 
this has not already been done. 

The special should be the physical disk section or tape (for 
example /dev/rdsk/c0d0s5, /dev/rmtO). 

The volname is the physical volume name (for example, pk3, 
t0122, and so forth) and should match the external label 
sticker. Such label names are limited to six or fewer charac- 
ters. Volname may be - to use the existing volume name. 

Speciall and volnamel are the device and volume from which 
the copy of the file system is being extracted. Special2 and 
volname2 are the target device and volume. 

Fsname and volname are recorded in the last 12 characters of 
the superblock (char fsname[6], volname[6];). 

FILES 

/etc/log/filesave.log a record of file systems/volumes 

copied 

EXAMPLE 

The following command backs up the root file system to a 
tape: 

vol copy -a root /dev/rdsk/cOdOsI do /dev/rmtO epochl 

SEE ALSO 

labelit(IM). 

fs(4) in the Programmer's Reference Manual. 
sh(1) in the User's Reference Manual. 

WARNINGS 

Volcopy does not support tape-to-tape copying. Use dd(1M) 
for tape-to-tape copying. 

BUGS 

Only device names beginning /dev/rmt are automatically 
treated as tapes. Tape record sizes are determined both by 
density and by drive type. For half-inch tapes, records are 
5,120 bytes long at 800 and 1600 bits-per-inch, and 25,600 
bytes long at 6250 bits-per-inch. 
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NAME 

whodo - who is doing what 

SYNOPSIS 
/etc/whodo 

DESCRIPTION 

Whodo produces formatted and dated output from informa- 
tion in the /etc/utmp and /etc/ps_data files. 

The display is headed by the date, time, and machine name. 
For each user logged in, device name, user-ID, and login time 
are shown, followed by a list of active processes associated 
with the user-ID. The list includes the device name, process-ID, 
CPU minutes and seconds used, and process name. 

EXAMPLE 

The command: 

whodo 

produces a display like this: 

Tue Mar 12 15:48:03 1985 
bailey 

tty09 men 8:51 

tty09 28158 0:29 sh 

tty52 bdr 15:23 

tty52 21688 0:05 sh 
tty52 22788 0:01 whodo 
tty52 22017 0:03 vi 
tty52 22549 0:01 sh 

xt162 lee 10:20 

xt162 6751 0:01 sh 
xt163 6761 0:05 sh 
tty08 6536 0:05 Sh 

FILES 

/etc/passwd 
/etc/ps_data 
/etc/utmp 

SEE ALSO 

ps(1), who(1) in the User's Reference Manual. 
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NAME 

intro - introduction to special files 
DESCRIPTION 

This section describes various special files that refer to specific 
hardware peripherals and 6000/50 system device drivers, 
including networking protocol drivers. Features common to a 
set of protocols are documented as a protocol family. 
STREAMS [see /nfro(2)] software drivers, modules and the 
STREAMS-generic set of /ocf/(2) system calls are also 
described. 

Hardware Entries 

For hardware related files, the names of the entries are gen- 
erally derived from names for the hardware, as opposed to 
the names of the special files themselves. Characteristics of 
both the hardware device and the corresponding 6000/50 sys- 
tem device driver are discussed where applicable. 

Disk device file names are in the following format: 

/dev/{r}dsk/c#d#s# 

where r indicates a raw interface to the disk, c# indicates the 
controller number, d# indicates the device attached to the 
controller and s# indicates the section number of the parti- 
tioned device. 

Protocol Family Entries 

A protocol family provides basic services to the protocol imple- 
mentation to allow it to function within a specific network 
environment. These services may include packet fragmenta- 
tion and reassembly, routing, addressing, and basic transport. 
A protocol family may support multiple methods of address- 
ing, though the current protocol implementations do not. A 
protocol family is normally comprised of a number of proto- 
cols, one per sockef (2B) type. It is not required that a proto- 
col family support all socket types. A protocol family may 
contain multiple protocols supporting the same socket 
abstraction. 

A protocol supports one of the socket abstractions detailed in 
socket (2B). A specific protocol may be accessed by creating 
a socket of the appropriate type and protocol family, by 
requesting the protocol explicitly when creating a socket, by 
executing the appropriate TLI primitives, or by opening the 
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associated STREAMS device. 
Protocol Entries 

The system currently supports the DARPA Internet protocols. 
Raw socket Interfaces are provided to the IP protocol layer of 
the DARPA Internet and to ICMP protocol. Consult the 
appropriate entries in this section for more information. 

Routing Ioctls 

The network facilities provide limited packet routing. A simple 
set of data structures comprise a "routing table" used in 
selecting the appropriate network interface when transmitting 
packets. This table contains a single entry for each route to a 
specific network or host A user process, the routing daemon, 
maintains this data base with the aid of two socket-specific 
iocti(2) commands, SOICADDRT and SOICDELRT. The com- 
mands allow the addition and deletion of a single routing table 
entry, respectively. Routing table manipulations may only be 
carried out by the super-user. 

A routing table entry has the following form, as defined in 
<net/route.h>: 

struct rtentry \ 

u_1ong rt_hash; 

struct sockaddr rt_dst; 

struct sockaddr rt_gateway; 

short rt_f1ags; 

short rtjrefcnt; 

u_long rt_use; 

struct if net *rt.Jfpj 

i; 

The rt_flags are defined as follows: 

#define RTFJJP 0x1 /* route usable*/ 

#define RTF_GATEWAY 0x2 /* destination is a gateway */ 
^define RTF_H0ST 0x4 /* host entry (net otherwise) */ 
^define RTF_DYNAMIC 0x10 /* created dynamically */ 

/* (by redirect) */ 

Routing table entries are of three general types: those for a 
specific host, those for all hosts on a specific network, and 
those for any destination not matched by entries of the first 
two types (a wildcard route). When the system is booted and 
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addresses are assigned to the network interfaces, each proto- 
col family installs a routing table entry for each interface when 
it is ready for traffic. Normally the protocol specifies the route 
through each interface as a "direct" connection to the destina- 
tion host or network. If the route is direct, the transport layer 
of a protocol family usually requests the packet be sent to the 
same host specified in the packet. Otherwise, the interface is 
requested to address the packet to the gateway listed in the 
routing entry (that is, the packet is forwarded). Some routing 
entries specify a connection requiring some form of dialing. 

Routing table entries installed by a user process may not 
specify the hash, reference count, use, or interface fields; 
these fields are filled in by the routing routines. If a route is in 
use when it is deleted (rtjrefcnt is non-zero), the routing entry 
is marked down and removed from the routing table, but the 
resources associated with it are not reclaimed until all refer- 
ences to it are released. The routing code returns EEXIST if 
requested to duplicate an existing entry, ESRCH if requested 
to delete a non-existent entry, or ENOSR if insufficient 
resources were available to install a new route. User 
processes read the routing tables through the /dev/kmem 
device. The rt_use field contains the number of packets sent 
along the route. 

When routing a packet, the kernel first attempts to find a 
route to the destination host. Failing that, a search is made 
for a route to the network of the destination. Finally, any 
route to a default ("wildcard") gateway is chosen. If multiple 
routes are present in the table, the first route found is used. If 
no entry is found, the destination is declared to be unreach- 
able. 

A wildcard routing entry is specified with a zero destination 
address value. Wildcard routes are used only when the sys- 
tem fails to find a route to the destination host and network. 
The combination of wildcard routes and routing redirects can 
provide an economical mechanism for routing traffic. 

Interface IOCTLs 

Each network interface in a system corresponds to a path 
through which messages may be sent and received. A net- 
work interface usually has a hardware device associated with 
it, although certain interfaces such as the loopback interface, 
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/o(7B), do not. 

The following ioctl calls may be used to manipulate network 
interfaces. The ioctl is made on a socket (typically of type 
SOCK_DGRAM) in the desired "communications domain" [see 
protocols (4B)]. Unless specified otherwise, the request takes 
an ifrequest structure as its parameter. This structure has the 
form: 

struct ifreq { 

char ifrjrjame[16]; /* name of interface */ 
/* (e.g. ecO) */ 

union [ 

struct sockaddr ifru_addr; 
struct sockaddr ifru_dataddr; 
struct sockaddr ifru_broadaddr; 
short ffru_flags; 
int ifru_jnetrfc; 
] ifr.ifru; 

^define ifr_addr ifr_ifru. ifru_addr /* address */ 
^define ifr_dstaddr ifr_ifru.ifru_dstaddr /* other end */ 

/* of p-to-p */ 
/* link */ 

^define ifr_broadaddr ifr_ifru.ifru_broadaddr /* broadcast */ 

/* address */ 

#deffne ifr_f1ags ifr_ifru.ifru_flags /* flags */ 
^define ifrjnetric ifr_ffru.ifru_metric /* routing */ 

/* metric */ 

i; 

SIOCSIFADDR 

Set interface address for protocol family. Following the 
address assignment, the "initialization" routine for the 
interface is called. 

SIOCGIFADDR 

Get interface address for protocol family. 

SIOCS1FDSTADDR 

Set point-to-point address for protocol family and inter- 
face. 

SIOCGIFDSTADDR 

Get point-to-point address for protocol family and inter- 
face. 
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SIOCSIFBRDADDR 

Set broadcast address for protocol family and interface. 

SIOCGIFBRDADDR 

Get broadcast address for protocol family and interface. 

SOICSIFFLAGS 

Set interface flags field. If the interface is marked down, 
any processes currently routing packets through the inter- 
face are notified; some interfaces may be reset so that 
incoming packets are no longer received. When marked 
up again, the interface is reinitialized. 

SOICGIFFLAGS 

Get interface flags. 

SIOCSIFMETRIC 

Set interface routing metric. The metric is used only by 
user-level routers. 

SIOCGIFMETRIC 

Get interface metric. 

SIOCGIFCONF 

Get interface configuration list. This request takes an 
ifconf structure (see below) as a value-result parameter. 
The ifcjen field should be set initially to the size of the 
buffer pointed to by ifcjbuf. On return it contains the 
length, in bytes, of the configuration list. 

/* Structure used in SIOCGIFCONF request. */ 
/* Used to retrieve interface configuration */ 
/* for machine (useful for programs which */ 
/* must Know all networks accessible). */ 

struct ifconf { 

int ifc_len; /* size of associated */ 

/* buffer */ 

union \ 

caddr_t ifcu_buf; 
struct ffreq *ifcu__req; 

I ifc_ifcu; 

#define ifc_buf ifc_ifcu.ifcu_buf /* buffer address */ 
jjfdefine ifcjreq ifc_ifcu.ifcu_req /* array of structures */ 

/* returned */ 

I; 
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STREAMS Ioct) Interface 

Socket ioctl calls can also be issued using STREAMS file 
descriptors. The standard strioctl structure is used, with the 
lc_cmd field containing the socket ioctl code (from 
<sys/socket.h>) and the lc_db field pointing to the data 
structure appropriate for that ioctl. 

Options management is done using the TLI primitives and the 
following structure, which contains the arguments to the 
"sockopts" calls: 

struct optdesc { 
int level; 
int optname; 
int value; 

u 

SEE ALSO 

ioctl(2), socket(2B) in the Programmer's Reference Manual. 



/* Protocol Level Affected */ 
/* option name to modify */ 
/* value set or retrieved */ 
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NAME 

clone - open any minor device on a STREAMS driver 
DESCRIPTION 

Clone is a STREAMS software driver that finds and opens an 
unused minor device on another STREAMS driver. The minor 
device passed to clone during the open is interpreted as the 
major device number of another STREAMS driver for which an 
unused minor device is to be obtained. Each such open 
results in a separate stream to a previously unused minor dev- 
ice. 

The clone driver consists solely of an open function. This 
open function performs all of the necessary work so that sub- 
sequent system calls [including c/ose(2)] require no further 
involvement of clone. 

Clone will generate an ENXIO error, without opening the dev- 
ice, if the minor device number provided does not correspond 
to a valid major device, or if the driver indicated is not a 
STREAMS driver. 

CAVEATS 

Multiple opens of the same minor device cannot be done 
through the clone interface. Executing sraf(2) on the file sys- 
tem node for a cloned device yields a different result from 
executing fstat [see sfaf(2)J using a file descriptor obtained 
from opening the node. 

SEE ALSO 

iog(7). 

System V Operating System STREAMS Programmer's Guide. 
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NAME 

disk - disk format and driver 

SYNOPSIS 

#Include < sys/types.h > 
^include < sys/gdisk.h > 
^include <sys/gdioctl.h> 

DESCRIPTION 

The files /dev/dsk/cOdOsO through /dev/dsk/cxdxsx and 
/dev/rdsk/cOdOsO through /dev/rdsk/cxdxsx refer to disk dev- 
ice names and slices, where cx is the controller number (in 
case of SCSI, the host SCSI controller), dx is the drive 
number, sx is the slice number, and x is a hexadecimal digit. 
An r in the name indicates the character (raw) interface. 

The 6000/50 formats a disk with 512-byte physical sectors. 
Block input/output uses 1024-byte logical blocks. 

The logical block on cylinder 0, track 0 contains the Volume 
Home Block, which describes the disk. The following structure 
defines the volume home block. 

struct vhbd \ 

uint magic; /* disk format code */ 

int chksum; /* adjustment to 32 bit sum */ 

/* starting from magic for */ 
/* IK bytes sums to -1 */ 
struct gdswptr dsk; /* specific description of */ 

/* this disk */ 
struct partit partab{MAXSLICEJ;/* partition table */ 
struct resdes \ /* reserved area for */ 

/* special files */ 
daddr_t blkstart; /*start logical block # */ 
ushort nb locks; /* length in logical blocks */ 
/* (zero implies not */ 
/* present) */ 

] resmap[8J; 

/* resmap consists of the following entries: */ 

/* loader area */ 

/* bad block table */ 

/* dump area */ 

/* bootable program, */ 

/* size determined by a. out format. nblocks=1 */ 
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char fpulled; /* dismounted last time? */ 

long time; /* time last came on line */ 

struct gdswprt2 dsk2; /* drive specific parameters */ 

struct partit_ext part_ext[MAXSLICE]; 

char sysres[198]; /* custom system area */ 
char reserved! 256 ] ; 



union | 

char usera[228]; 
struct \ 

short cpiomagic, 
setmagic, 
cpiovol , 
pad; 

char usera{220J; 
] s4ua; 

\ ua; 

uint resvO; 
ulnt total blks; 

1; 

#define VHBJ4AGIC 0x55515651 

jffdefine cpioHagic 
^define setMagic 
#define cpioVol 

/* indexes into resmap */ 
^define INDLOADER (( short )0) 
^define I NDBBTBL (( short )1) 
#define INODUMP (( short )2) 
^define INDBOOT ( (short )3) 

struct gdswprt f 



/* user area */ 
/* user area */ 

/* for cpio backup, restore */ 

/* to pad to same size */ 
/* as usera */ 

/* magic number in disk vhb */ 



ua.s4ua. cpiomagic 
ua.suua. setmagic 
ua.s^ua. cpiovol 



char name[6J; /* printf name */ 
ushort cyls; /* the number of cylinders for this */ 
/* disk */ 

ushort heads; /* number of heads per cylinder */ 
ushort psectrk; /* number of physical sectors per */ 
/* track */ 

ushort pseccyl; /* number of physical sectors per */ 
/* cylinder */ 
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char flags; /* floppy density and high tech */ 

/* drive flags */ 
char step; /* reserved for future use */ 
ushort sectorsz; /* size of physical sectors */ 

/* (in bytes) */ 

I; 

struct gdswprt2 \ 
short wpccyl ; 
short unused{5); 
uint 1 sectors; 
uint reserved[61; 

I; 

/* disk si ice table 
struct part it \ 

union [ 

uint strk; 

I sz; 

I; 

struct partit_ext { 
ushort p_flat; 
ushort p^tag; 
uint reserved; 

U 

/* provide a way to let loader know where */ 
/* root and swap can be found */ 
#def ine p_ROOTTAG 0x01 
#def ine P.SWAPTAG 0x02 

f* disk slice table in memory */ 
struct mpartit \ /* partition table */ 

uint strk; /* start track # */ 

uintnsecs; /* 0 of logical sectors */ 

/* available to user */ 

U 

If a volume home block is valid, magic is equal to VHBMAGIC 
and the 32-bit sum of the volume home block's bytes of 
OxFFFFFFFF (-1); chksum is the adjustment that makes the 
sum come out right. 



/* reserved for future use */ 
/* # of blocks for this disk */ 



V 

/* start track number */ 
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Dsk describes the pecularities of the disk, including deliberate 
deviations from the system standard. DskJIags can be: 

EXCHANGEABLE 

If on, the disk is a floppy or removable hard disk car- 
tridge. If off, the disk is a fixed disk. 

Partab divides the disk into slices (partitions). 

Resmap describes the files that share Slice 0 with the volume 
home block. Provision is made for eight such files, but only 
four have been assigned slots in resmap. Each resmap entry 
gives the starting location (logical block number) and length 
(logical blocks). A length of zero indicates that the file is not 
provided. The first five entries in resmap describe: 

1. The loader. When the system is reset or turned on, the 
boot prom loads the loader into the loader address and 
jumps execution to it. The function of the loader is to 
search for and load a program that will boot the system. 

On the 6000/50, the loader searches the tape drive, then 
the SCSI disk, in that order. 

On each device, the loader first checks for a standalone 
program. If the disk lacks a standalone program, the 
loader checks for a System V kernel, which must be a 
6000/50 executable object file called /unix in the file sys- 
tem in slice 1. When the loader locates an appropriate 
program, it loads the program it found into address 
0x10000 and executes it. If no device contains an 
appropriate file, the loader continues searching until an 
appropriate tape or disk is inserted. 

2. The dump area. After Reset or Suicide, the boot prom 
dumps the contents of physical memory, until it runs out 
of room in the dump area. 

3. A bootable program, usually a diagnostic. This is the pro- 
gram the loader considers a substitute for the /unix file. 
The program must be in a.ouf{4) format with magic 
number 407 or be a simple memory image. 

If the fifth entry in resmap has a zero address but a 
nonzero length, the loader looks at the beginning of slize 
1 for the program. 
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Slice 0 is called the Reserved Area. Only the volume home 
block and the files described by resmap can be in the 
Reserved Area. A formatted disk used by a working system 
would have at least one more slice. 

Ioctl system calls use the following structure. 



struct gd ioctl \ 
ushort status; 
struct gdswprt params; 
struct gdswprt2 params2; 

short ctrltyp; 

short driveno; 
uint totalblks 

I; 



/* status */ 

/* description of the disk */ 
/* more description of the */ 
/* disk */ 

/* the type of disk */ 
/* controller */ 

/* total blocks available */ 
/* for use */ 



Totalblks is less than cylinders * heads * sectors per track for 
SCSI disks, due to the tracks allocated for SCSI overhead. 

Status is the bitwise OR of the following constants. 

OPENED 

Indicates an attempt has been made to read the VHB. 
Set when the first open is performed for any slice on this 
disk; cleared when the drive goes off line. 

CTFMT 

A valid VHB has been read for this disk. 
READY 

The disk controller has signalled that the disk is ready. 
WRPROT 

Write protect status; set if the media is write protected. 
This flag is set after each transfer. 

WINCH 

Set if the drive is a Winchester. 
EXCH 

Set if the drive accepts exchangeable media (floppy 
drive). 

Params is a gdswprt structure, the same type used in the 
volume header block. 
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Ctrltyp is equal to: 

GDJVD1010 

for Western Digital 1010 ST506 controller. 

GD_NEC 

for NEC 765 floppy controller. 

GDJVD2797 

for Western Digital 2797 floppy disk controller. 

GD_RAMDISK 

for RAM disk emulator. 

GD_SCSI 

for WD33C93 SCSI controller. 

System V understands the following disk ioctl calls: 

ioctl(fd» GDIOCTYPE, 0) 

Returns GDIOC if fd is a file descriptor for a disk special 
file. 

ioctl(fd, GDGETA, gdctl_ptr) 

Gdctl _ptr is a pointer to a gdiocti structure. Ioctl fills the 
structure with information about the disk. 

ioctl(fd, GDSETA, gdcti_ptr) 

Gdctl _ptr is a pointer to a gdiocti structure. Ioctl passes 
the description of the disk to the disk driver. This is pri- 
marily meant for reading disks created by other kinds of 
computers. 

ioctl(fd, GDFORMAT, ptr) 

Ptr points to formatting information. The disk driver for- 
mats a track. 

ioctl(FD, GDDISMNT) 

Ioctl informs the driver that the user intends to remove 
the disk from the drive. When this system call success- 
fully returns, the driver has flushed all data in the buffer 
cache and waited for ail queued transfers to complete. 
The last transfer is to write out the volume home block. 
Once this call returns, the drive is inaccessible until a new 
disk is inserted. 

ioctl(fd, GDRETRY) 

Disable/enable error retry. If the argument is 0, error 
retry is enabled; otherwise error retry is disabled. 
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SEE ALSO 

mknod(1M), 

iocti(2) in the Programmer's Reference Manual. 
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NAME 

drivers - loadable device drivers 
DESCRIPTION 

A loadable driver is equivalent to a fixed, linked-in device 
driver. It has access to all kernel subroutines and global data. 
After it is loaded, it is effectively part of the running kernel. 

For a device driver to be loadable by IddrvftM), an entry for 
the device must be made in the master file /etc/master. 

Differences between loadable and ordinary drivers involve their 
driver ID, init routine, release routine, and interrupt processing. 

Init Routines 

Loadable drivers may have an init routine that is executed 
when the driver is bound, and a release routine that is exe- 
cuted when the driver is unbound (see Iddrv^M) for a 
description of driver allocation and bind operations). Init rou- 
tines check for the existence of hardware, initialize the 
hardware, put the interrupt service routine for the hardware 
into the interrupt chain, and do other similar tasks. 

Release Routines 

Release routines make sure the device or driver is idle, turn off 
the device, take the interrupt service routine out of the inter- 
rupt chain, and perform similar tasks. A typical action for a 
release routine to take when the device is not idle is to set an 
error code in u.u_error and return. If the device is 
guaranteed to become idle in a limited amount of time, the 
routine may do a sleep () or delay {), 

Interrupt Routines 
Expansion boards may reside on the AT bus or the Mbus. 
Boards on the AT bus may use any of the AT interrupts, num- 
bered 0 through 15. Boards on the Mbus use interrupts num- 
bered 16 through 23. The hardware allows only one device 
per interrupt. See the U 6000 Series Technical Reference 
Manual for interrupts used by the base hardware and Unisys 
options. 
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When an interrupt occurs, the routine associated with that 
interrupt is executed. If the routine returns zero, a "spurious 
interrupt" message is logged in /usr/adm/unix.log. 

It is the responsibility of the interrupt routine for a device to 
return 0 if it is called with no interrupt outstanding on its dev- 
ice and return non-zero and clear the interrupt if one does not 
exist for its device. 

The routines sef_vec{) and reset jec{) are provided to add 
and delete interrupt service routines from the interrupt chain 
associated with a specific interrupt. The routines set_spl() 
and resef_sp/() are provided to add and delete drivers from 
the spl structures so that the spl functions are aware of the 
new interrupt. Sef_sp/{) assigns an spl level (a number 
between 0 and 15) to the device. Standard spl levels for vari- 
ous devices (disk, tape, serial, network, and so forth) are 
defined in spf.h and should be used whenever possible. 
Assigning an improper spl level to a device can cause 
unpredictable and sometimes fatal results. Setjspl() also 
enables the interrupt, if it has not yet been enabled by 
another driver. 

Driver ID 

All drivers have a driver ID. Preloaded drivers have a driver ID 
of 0. Loaded drivers are given an ID when they allocate virtual 
space. The driver ID is automatically set when the driver is 
linked. The ID should never be modified by the driver itself; 
the ID is used to identify the driver to the system when mak- 
ing certain requests. 

FILES 

/etc/master 

SEE ALSO 

config(1M), lddrv(1M). 
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NAME 

enet - Ethernet interface and control 
DESCRIPTION 

The Ethernet interface defines a message interface to an Eth- 
ernet driver implemented under streams. This stream pro- 
vides a mechanism by which messages may be passed to the 
Ethernet driver from the consumer and vice versa. 

The Ethernet driver is a data link layer service. It is based on 
the definitions of the IEEE-802.3/Ethernet standard. 

The stream message types that are used to communicate 
between the consumer and the Ethernet driver have the fol- 
lowing format: 

• An M_PROTO message block possibly followed by one or 
more M_DATA message blocks. The M_PROTO message 
block contains the service primitive types and the relevant 
arguments associated with the primitives. The M_DATA 
blocks contain any consumer data associated with the 
service primitive. 

• An M PCPROTO message block containing the service 
primitive type and all relevant arguments associated with 
the primitive. 

The Ethernet interface consists of two phases of communica- 
tion: initialization/deinitialization and data transfer. The follow- 
ing describes the format of the initialization or de-initialization 
primitives between the consumer and Ethernet driver. 

Consumer Originated Primitives 
DLJNFO_REQ 

~Get Ethernet protocol parameter sizes. This primitive 
requests the Ethernet driver to return the size of all 
relevant parameters and the current state of the Ethernet 
driver. The format of the message is one M_PCPROTO 
message block. 

struct DL_info_req \ 

long PRIMtype; /* always DL_INFO_REQ */ 

u 

Return: Acknowledgment of the primitive via the 
DL_INFO_ACK primitive. 
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Error: These errors are indicated via the 
DL_ERROR_ACK primitive. The allowable errors 
are as follows: 

DLSYSERR 6000/50 system error 

DL_BIND_REQ 

Bind protocol address request. This primitive requests 
that the Ethernet driver bind a service access point to the 
stream and return the link layer address associated with 
the stream. The format of the message is one M_PROTO 
message block. 

struct DLJbindjreq \ 

long PRIM_type; /* always DL_BIND_REQ */ 

long LLC^sap; /* the LSAP selector */ 

long GR0WTH_fieldI2]; J* 802.2 lie type 2 */ 
/* fields */ 

U 

Return: Acknowledgment of the primitive via the 
DL_BIND_ACK primitive. 

Error: These errors are indicated via the 
DL_ERROR_ACK primitive. The allowable errors 
are as follows: 

DLBADSAP bad LSAP selector 

DLACCES inproper permissions 

DLOUTSTATE Link layer interface 

out of state 
DLSYSERR 6000/50 system error 

DL_UNBIND_REQ 

Unbind protocol address request. This primitive requests 
that the Ethernet driver unbind the protocol address asso- 
ciated with the stream and deactivate the stream. The 
format of the message is one M_PROTO message block. 

struct DL_unbind_req \ 

long PRIM_type; /* always DL_UNB1ND_REQ */ 

h 

Return: Acknowledgment of the primitive via the 
DL_OK_ACK primitive. 
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Error: These errors are indicated via the 
DL_ERROR_ACK primitive. The allowable errors 
are as follows: 

DLOUTSTATE Link layer interface 

out of state 
DLSYSERR 6000/50 system error 

Ethernet Driver Originated Primitives 
DLJNFO_ACK 

Protocol information acknowledgment. This primitive indi- 
cates to the consumer any relevant Ethernet driver depen- 
dent information. The format of this message is one 
M^PROTO message block. 

struct DL_info_ack f 

long PRIM_type; 
long SDUjnax; 
long SDUjnin; 
long ADDJMength; 

long SUB»€T_type; 
long SERV_class; 
long CURRENT_state; 
long GROWTH_field(2]; 

h 

The low order 16 bits of CURRENT^state contain the 
driver state as described below (DLJJNBND, DL_IDLE). 
The high order 16 bits contain interface flags, which are 
defined in net/if.h. 

DL_BIND_ACK 

Protocol bind acknowledgment. This primitive indicates to 
the consumer that the special link layer address has been 
bound to the stream and that the stream associated with 
the specified link layer address has been actived. The for- 
mat of the message is one M_PROTO message block. 

struct DL_bind_ack $ 

long PRIM.type; /* always DL_BIN0_AGK */ 

long LLC_sap; /* lsap selector */ 

long ADOR_length; /* LSAP address length */ 
/* in bytes */ 



/* always DL_!NF0_ACK */ 
/* max isdu sl2e */ 
/* rain Isdu size */ 
/* LSAP address length */ 
/* in bytes */ 
/* subnet type */ 
/* service class */ 
/♦link layer state */ 
/* 802.2 LLC2 fields */ 
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long ADDR_offset; /* LSAP address offset */ 

/* in the message */ 
long GROWTH.fi el d[2];/* 802.2 LLC2 fields */ 

i; 

DL_ERROR_ACK 

Error acknowledgment. This primitive indicates to the 
consumer that a error has ocurred in the last consumer 
originated primitive. It indicates to the consumer that no 
action was taken on the primitive that caused the error. 
The format of the message is one M_PCPROTO message 
block. 

struct DL_error_ack I 

long PRlM_type; /* always DL_ERR0R_ACK */ 
long ERROR_prim; /* primitive in error */ 
long LLC_error; /* LLC error code */ 
long UN I X_error; /* error code */ 

i; 

DL_OK_ACK 

Success acknowledgment. This primitive indicates to the 
consumer that the previous consumer originated primitive 
was received successfully by the Ethernet driver. The for- 
mat of the message is one M_PCPROTO message block. 

struct DL_ok__ack \ 

long PRIM_type; /* always DL_OK_ACK */ 
long 00RRECT_prlm; /* correct primitive */ 

I; 

The following describes the format of the data transfer primi- 
tives between the consumer and Ethernet driver. 

Consumer Originated Primitives; 

DL_UNITDATA_REQ 

Unitdata send request. This primitive requests that the 
Ethernet driver send the specified datagram to the speci- 
fied destination. The format of this message is one 
M_PROTO message block followed by one or more 
M_DATA message blocks. 

struct DL_unitdata_req \ 

long PRIM.type; /* always DL_UN I TDATA_REQ */ 
long RA_lengtrt; /* dest LSAP addr length */ 
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long RA_offset; /* dest LSAP addr offset */ 
long SERY_class; /* service class */ 
long FILLER_f ield; /* 802.2 LLC2 field */ 

i; 

Ethernet Driver Originated Primitives: 

DLUNITDATAJND 

Unitdata receive indication. This primitive indicates to the 
consumer that a datagram has been received from the 
specified remote address. The format of this message is 
one M_PROTO stream message block followed by one or 
more M_DATA blocks. 



struct DL_unftdata_tnd [ 




long 


PRlM_type; 


/* always DLJJNITDATAJNO */ 


long 


RA_length; 


/* dest LSAP address */ 






/* length in bytes */ 


long 


RA_offset; 


/* dest offset LSAP into */ 






/* message */ 


long 


LAJength; 


/* src LSAP address length */ 






/* in bytes */ 


long 


LAj>ffset; 


/* src offset LSAP into */ 






/* message */ 


long 


SERV_class; 


/* service class */ 



li 

DLJJDERRORJND 

" Unitdata error indication. This indicates to the consumer 
that a datagram with the specified remote address pro- 
duced an error. The format of this message is one 
M _PROTO message block. 

struct DL_uderrorJnd \ 



long 


PRIM_type; 


/* always DLJJDERRORJND */ 


long 


RAJength; 


/* dest LSAP address length */ 






/* in bytes */ 


long 


RA_offset; 


/* dest LSAP offset into msg */ 






/* in bytes */ 


long 


SERV_class; 


/* service class */ 


long 


ERROR__type; 


/* error type */ 



is 

The definitions of consumer primitives are as follows: 
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DL_INFO_REQ 

DL_BIND_REQ 
DL_UNBIND_REQ 
OL_UN I TDATA_REQ 



0 /* data link layer protocol parameter */ 



/* sizes */ 

/* bind protocol address request */ 
/* unbind protocol address request */ 
/* unit_data send request */ 



The definitions of Ethernet primitives are as follows: 



DL_.INFCL.ACK 

DL_B!ND_ACK 

DL_ERROR_ACK 

DL_OK_ACK 

DL__UN 1 TDATA_ I ND 

OL_UDERROR_IND 



/* protocol information acknowledgement */ 
/* protocol bind acknowledgement */ 
/* error acknowledgement */ 
/* success acknowledgement */ 
/* unitdata receive indication */ 
f* unitdata receive indication */ 

The primitive non-fatal error return codes are described as fol- 
lows: 

DLBADSAP 0 /* bad LSAP selector */ 
DLACCES 2 /* inproper permissions */ 
DLOUTSTATE 3 /* Link layer interface out of state */ 
DLSYSERR ti /* 6000/50 system error */ 

Subnetwork types are: 

DLjCSMACO 0 /* CSMA/CD network (802.3) */ 
DL_TPB 1 /* Token Passing Bus (802.4) */ 
DL_TPR 2 /* Token Ring Bus (802.5) */ 
DLJCTRO 3 /* Metro Net (802,6) */ 
DL_ETHER 4 /* ETHERNET bus */ 

There are two kinds of service classes for the data link layer. 
The Ethernet driver is a no-service class. 

DL_N0SERV 0 /* No service class */ 
DL_CLASSES 1 /* Has a service class */ 

The current state of the Ethernet driver is defined as follows: 



dljjnbno o 

Di__WACK_B 1 

DL_WACK_U 2 

DL IDLE 3 



/* LL not bound */ 
/* LL waiting for bind ack */ 
/* LL waiting for unbind ack */ 
/* LL is active */ 

Ioctls 

Five ioctls are supported by the Ethernet driver. When these 
ioctls are issued by the user level, an MJOCTL message and 
the relevant parameters are generated by the stream head 
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and sent downstream. 

The format of these ioctls is as follows: 

foctl(enet, I„STR, &ioc) 

I_STR contructs a MJOCTL message from the data pointed to 
by &ioc and sends that message downstream. For this 
request, the iocti blocks until the system responds with either 
an MJOCACK (positive acknowledgement) or MJOCNACK 
(negative acknowledgement). 

To send these ioctls, ioc must point to a structure of the fol- 
lowing form: 

struct str iocti [ 

int ic_cmd; /* command */ 
int ic_timout; /* timeout value */ 
int 1c_len; /* length of data */ 
char *ic_dp; /* pointer to data */ 

U 

For selecting the hardware for the ethernet interface, each 
parameter in the structure of strioctl may be set as follows : 

ioc.ic_cmd « IFUNITSEL; 
ioc.tcjtimout = 0; 
ioc. ic Jen = sizeof(int); 
ioc.ic_dp = (char *) &unit; 

where unit is the selected unit number, 0 or 1 to select the 
first or second Ethernet board. 

For getting the Ethernet address from the hardware, each 
parameter in the structure of strioctl may be set as follows : 

ioc.ic_cmd = SIOCGENADDR; 
ioc.icjimout = 0; 
ioc. ic Jen = 0; 
ioc.ic_dp = buf; 

where buf is an array of NADDRLEN(6) bytes. When the iocti 
returns, buf has been filled with the Ethernet address. 

For reading Ethernet statistics, the strioctl fields are set as fol- 
lows: 

ioc.ic_cmd = SIOCGENPSTATS; 
ioc.icjimout = 0; 
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loc.icjen = 0; 
ioc.ic_dp =s &enpstat; 

where enpstat is a struct enpstats, defined in if_enp.h. 

For getting the interface flags, set: 

ioc.iccmd = SIOCGIFFLAGS; 
ioc.ic_timout = 0; 
ioc.icjen = sizeof(struct tfreq); 
ioc.ic_.dp = &ifreq; 

For setting the interface flags, set: 

iocicjjmd = SIOCSIFFLAGS; 
ioc.icjimout = 0; 
ioc.icjen = sizeof (struct if req); 
ioc.ic_dp = & if req; 

where ifreq is a structure defined in net/if .h. The flags are 
returned in ifreq.ifrjlags. 

FILES 

/dev/enet 
/dev/enet2 

/usr/include/sys/tihdr.h 

/usr/include/sys/stropts.h 

/usr/inctude/sys/stream.h 

/usr/include/sys/socket.h 

/usr/inc.ude/net/if.h 

/usr/include/netinet/if_enp.h 

/usr/include/netinet/if_ether.h 

/usr/include/sys/comm.h 

SEE ALSO 

streamio(7) 
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NAME 

err - error-logging interface 
DESCRIPTION 

Minor device 0 of the err driver is the interface between a pro- 
cess and the system's error- record collection routines. The 
driver may be opened only for reading by a single process 
with super-user permissions. Each read causes an entire error 
record to be retrieved and removed; the record is truncated if 
the read request is for less than the record's length. 

FILES 

/dev/error special file 

SEE ALSO 

errdemon(IM). 
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NAME 

fd - floppy disk (diskette) 

DESCRIPTION 

The 6000/50 supports up to two diskette drives. The diskette 
driver provides access to diskettes as both block and charac- 
ter devices. The minor device number for diskette devices is 
14 (OxOE). 

Diskettes must be formatted with 512 bytes per sector with 
MFM encoding by the /V(1) program. Diskettes may be either 
single-sided or double-sided double-density, or double-sided 
high density. The 6000/50 does not support single-density 
diskettes. Support is provided for 5.25 M high density and dou- 
ble density drives, and 2.5" high density and double density 
drives. At system boot time, the equipment byte (0x14) in 
CMOS RAM is read to determine what drive types are 
installed. 

The device file names associated with diskette drives are in 
one of two formats. The 6000/50 format is similar to fixed disk 
layout and includes the 6000/50 volume home block (VHB). 
The second format is compatible with the standard 80386 
UNIX port; cylinder 0 may be reserved for bootable tracks. 

The 6000/50 compatible format is as follows: 

/dev/(r)dsk/ced#s# 

where r, if present, indicates a raw (character) interface to the 
diskette, d# is the drive number and can be 0 or 1 , and s# is 
the slice number (# is between 0 and 7 hex). 

The standard 80386 UNIX-compatible format is as follows: 

/dev/(r)dsk/fx[dq]n[d]{tj 

where the initial d or q selects double or quad density, x is 0 
or 1, n is 8, 9, or 15, the second d indicates a double-sided 
diskette, and t indicates that the whole diskette is used 
(including the boot track). 

Using this format, the following device names are mapped to 
the following diskette slices for 5.25" drives, where n can be 0 
or 1: 

high density drive double density drive slice 
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fnq15dt 


f/?d9dt 


8 


fnq15d 


fndqd 


9 


fnd9dt 


f/7d9t 


10 


fnd9d 


fr?d9 


11 


fndSdt 


fndSdt 


12 


fnd8d 


fnd8d 


13 


fnd8t 


fnd8t 


14 


fnd8 


fnd8 


15 



The following device names are mapped to the following 
diskette slices for 3.5" drives, where n can be 0 or 1: 

high density drive double density drive slice 



fnq18dt 


fnd9dt 


8 


fnq18d 


fnd9d 


9 


fnd9dt 


fnd9dt 


10 


fnd9d 


fr?d9d 


11 


fnd9dt 


fnd9dt 


12 


fnd9d 


fnd9d 


13 


fnd9dt 


fnd9dt 


14 


fnd9d 


fnd9d 


15 


SEE ALSO 







iv(1) in the User's Reference Manual. 



NOTE 

The standard 6000/50 release configures the first drive as a 
high density drive and the second drive as a double density 
drive. 
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NAME 

log - interface to STREAMS error logging and event tracing 
DESCRIPTION 

Log is a STREAMS software device driver that provides an 
interface for the STREAMS error logging and event tracing 
processes [strerr (1M) and strace (1M)]. Log presents two 
separate interfaces: a function call interface in the kernel 
through which STREAMS drivers and modules submit log mes- 
sages; and a subset of ioctl{2) system calls and STREAMS 
messages for interaction with a user level error logger, a trace 
logger, or processes that need to submit their own log mes- 
sages. 

Kernel Interface 

Log messages are generated within the kernel by calls to the 
function strlog: 

strlog(mid, sid, level, flags, fmt, arg1, . ..) 

short mid, sid; 

char level; 

ushort flags; 

char *fmt; 

unsigned arg1; 

Required definitions are contained in < sys/strlog.h > and 
<sys/log.h>. Mid is the STREAMS module ID number for 
the module or driver submitting the log message. Sid is an 
internal sub-ID number usually used to identify a particular 
minor device of a driver. Level is a tracing level that allows for 
selective screening out of low priority messages from the 
tracer. Flags are any combination of SL_ERROR (the mes- 
sage is for the error logger), SLJRACE (the message is for 
the tracer), SL^FATAL (advisory notification of a fatal error), 
and SLNOTIFY (request that a copy of the message be 
mailed to the system administrator). Fmt is a printf (3S) style 
format string, except that %s, %e, %E, %g, and %G conver- 
sion specifications are not handled. Up to NLOGARGS 
(currently 3) numeric or character arguments can be provided. 

User Interface 

Log is opened via the clone interface, /dev/log. Each open of 
/dev/Iog obtains a separate stream to log. In order to receive 
log messages, a process must first notify log whether it is an 
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error logger or trace logger via a STREAMS I_STR ioctl call 
(see below). For the error logger, the I_STR ioctl has an 
icjzmd field of I_ERRLOG, with no accompanying data. For 
the trace logger, the ioctl has an icjsrnd field of IJTRCLOG, 
and must be accompanied by a data buffer containing an 
array of one or more , struct trace Jds elements. Each 
trace Jds structure specifies an mid t sid, and level from which 
message will be accepted. Strlog will accept messages whose 
mid and sid exactly match those in the trace Jds structure, 
and whose level is less than or equal to the level given in the 
trace Jds structure. A value of -1 in any of the fields of the 
trace Jds structure indicates that any value is accepted for 
that field. 

At most one trace logger and one error logger can be active 
at a time. Once the logger process has identified itself via the 
ioctl call, log will begin sending up messages subject to the 
restrictions noted above. These messages are obtained via 
the gefmsg(2) system call. The control part of this message 
contains a logjitl structure, which specifies the mid, sid, level, 
flags, time in licks since boot that the message was submit- 
ted, the corresponding time in seconds since January 1, 1970, 
and a sequence number. The time in seconds since 1970 is 
provided so that the date and time of the message can be 
easily computed, and the time in ticks since boot is provided 
so that the relative timing of log messages can be determined. 

Different sequence numbers are maintained for the error and 
trace logging streams, and are provided so that gaps in the 
sequence of messages can be determined (during times of 
high message traffic some messages may not be delivered by 
the logger to avoid hogging system resources). The data part 
of the message contains the unexpanded text of the format 
string (null terminated), followed by NLOGARGS words for the 
arguments to the format string, aligned on the first word 
boundary following the format string. 

A process may also send a message of the same structure to 
log, even if it is not an error or trace logger. The only fields of 
the log_ctl structure in the control part of the message that 
are accepted are the level and flags fields; all other fields are 
filled in by log before being forwarded to the appropriate 
logger. The data portion must contain a null terminated 
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format string, and any arguments (up to NLOGARGS) must be 
packed one word each, on the next word boundary following 
the end of the format string. 

Attempting to issue an IJTRCLOG or IJERRLOG when a log- 
ging process of the given type already exists will result in the 
error ENXIO being returned. Similarly, ENXIO is returned for 
I_TRCLOG ioctls without any trace Jds structures, or for any 
unrecognized I_STR ioctl calls. Incorrectly formatted log mes- 
sages sent to the driver by a user process are silently ignored 
(no error results). 

EXAMPLES 

Example of I_ERRLOG notification. 

struct str ioctl ioc; 
foc.ic_cmd = I_ERRLOG; 

ioc.ic_timout - 0; /* default timeout (15 sees.) */ 

foc.icjen = 0; 
ioc.ic_dp = NULL; 

ioctl (log, l_STR, &ioc); 

Example of MTRCLOG notification. 

struct trace_ids Ud[2]; 

tid[0].ti_mid - 2; 
tid(01.ti_sid « 0; 
tid[0].ti_level = 1; 

tidl1J.ti_mid = 1002; 

tidp J.ti_sid = -1; /* any sub- ID will be allowed */ 

tid(1].ti_level = -1; /* any level will be allowed */ 

ioc.ic_cmd = IJTRCLOG; 
ioc.ic_timout = 0; 

(oc.ic_1en = 2 * sizeof (struct trace_ids); 
ioc.ic_dp = (char *)tid; 

ioctl (log, !_STR, &ioc); 

Example of submitting a log message (no arguments). 
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struct strbuf ctl, dat; 
struct log_ctl lc; 

char "message = "Don't forget to pick up some milk on the 
way home"; 

ctl.len = ctl.maxlen = sfzeof(lc); 
ctl.buf = (char *)&lc; 

dat. 1 en » dat .max 1 en = strl en (message); 
dat.buf = message; 

lc. level = 0; 

lc. flags = SL_ERROR!SL_NOTIFY; 
putmsg(log, &ctl, &dat, 0); 

FILES 

/dev/log 

<sys/log.h> 

<sys/strlog.h> 

SEE ALSO 

strace(1M), strerr(1M), clone(7). 

intro(2), getmsg(2), putrnsg{2) in the Programmer's Reference 
Manual. 

System V Operating System STREAMS Programmer's Guide. 
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NAME 

Ip - parallel printer interface 
DESCRIPTION 

Lp is an interface to the parallel printer channel. Bytes written 
are sent to the printer. Opening and closing produce page 
ejects. Unlike the serial interfaces [termio{7)], the Ip driver 
never prepends a carriage return to a new line (line feed). The 
Ip driver does have options to filter output, for the benefit of 
printers with special requirements. The driver also controls 
page format. Page format and filter options are controlled 
with ioctl(2): 

# include <sys/lpr io.h> 
ioctl (f ildes, command, arg) 

where command is one of the following constants: 

LPRGET Get the current page format and put it in the 

Iprio structure pointed to by arg. 

LPRSET Set the current page format from the location 

pointed to by arg; this location is a structure 
of type Iprio, declared in the header file: 

struct Iprio \ 
short fnd; 
short col; 
short line; 

I; 

Arg should be declared as follows: 

struct Iprio *arg; 

Ind is the page indent in columns, initially 4. Col is the 
number of columns in a line, initially 132, Line is the number 
lines on a page, initially 66. A newline that extends over the 
end of a page is output as a formfeed. Lines longer than the 
line length minus the indent are truncated. LPRSOPTS Set 
the filter options from arg, which must be of type int. Arg 
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should be the logical or of one or more of the following con- 
stants, defined in the header file: 

Constant Value Meaning 

LPNOBS 4 No back space. Set this bit if the printer 

cannot properly interpret backspace char- 
acters. The driver uses carriage return to 
produce equivalent overstriking. 

LPRAW 8 Raw output. Set this bit if the driver must 

not edit output in any way. The driver 
ignores all other option bits. 

LPCAP 16 Capitals. This option supports printers 

with a "half-ASCII" character set. Lower- 
case is translated to uppercase. The fol- 
lowing special characters are translated: { 
to {, } to }; x to I to \; ' to -. 

LPNOCR 32 No Carriage Return. This option supports 
printers that do not respond to a carriage 
return (character OD hexadecimal). Car- 
riage returns are changed to newlines. If 
No Newiine is also set, carriage returns 
are changed to form feeds. 

LPNOFF 64 No Form Feed. This option supports 
printers that do not respond to a form 
feed (character OC hexadecimal). Form 
Feeds are changed to newlines. If No 
Newiine is also set, form feeds are 
changed to carriage returns. 

LPNONL 128 No Newiine. This option supports printers 
that do not respond to a newiine (charac- 
ter OA hexadecimal). Newlines are 
changed to carriage returns. If No Car- 
riage Return is also set, newlines are 
changed to form feeds. 
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Setting all three of No Carriage Return, No 
New Line, and No Form Feed has the same 
effect as setting none of them. 

LPRGOPTS Return the current state of the filter options. 

Note that once set, options will remain intact through a close. 

FILES 

/dev/lp? 

SEE ALSO 

lpset{1M). 

Ipr(1) in the User's Reference Manual, 
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NAME 

mem, kmem - system memory image 
DESCRIPTION 

The file /dev/mem is a special file that is an image of the the 
system memory. It may be used, for example, to examine, 
and even to patch the system. 

Byte addresses in /dev/mem are interpreted as memory 
addresses. References to non-existent locations cause errors 
to be returned. 

Examining and patching device registers is likely to lead to 
unexpected results when read-only or write-only bits are 
present. 

The file /dev/kmem is the same as /dev/mem except that ker- 
ne! virtual memory rather than physical memory is accessed. 

The per-process text and data for the current process begins 
at 0x00000000. For 410 executabtes, per process data begins 
on the next 4K boundary. For 413 executables, per-process 
data begins in the first page of the next page directory 
(0x400000 boundary), with an offset in that page of .etext. 
Non-valid pages cause errors to be returned. 

FILES 

/dev/mem 
/dev/kmem 

WARNING 

Some of /dev/kmem cannot be read because of write- only 
addresses or unequipped memory addresses. 
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NAME 

null - the null file 

DESCRIPTION 

Data written on the null special file, /dev/null, is discarded. 

Reads from a null special file always return 0 bytes. 

FILES 

/dev/null 
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NAME 

prf - operating system profiler 
DESCRIPTION 

The special file /dev/prf provides access to activity information 
in the operating system. Writing the file loads the measure- 
ment facility with text addresses to be monitored. Reading 
the file returns these addresses and a set of counters indica- 
tive of activity between adjacent text addresses. 

The recording mechanism is driven by the system clock and 
samples the program counter at line frequency. Samples that 
catch the operating system are matched against the stored 
text addresses and increment corresponding counters for later 
processing. 

The file /dev/prf is a pseudo-device with no associated 
hardware. 

FILES 

/dev/prf 

SEE ALSO 

config(1M), profiler(iM). 
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NAME 

ramdisk, uramdisk - RAM disk drivers 
DESCRIPTION 

The RAM disk uses system memory as a disk device for stor- 
ing temporary or frequently accessed files to improve perfor- 
mance for I/O intensive applications. Due to the transient 
nature of this device (its contents are lost on power loss or 
when system software errors occur), and its effect of reducing 
memory for system operation, it should be used judiciously 
when valuable data is to be stored and when the system's 
memory is limited. 

The files /dev/dsk/cfdxsx and /dev/rdsk/cfdxsx refer to a dev- 
ice which appears to be a disk, but is actually some pages of 
system memory. This device is normally a loadable driver, so 
it must be loaded with Iddrv (1M) before it can be used. 

There are two variants of the device: the device named "ram- 
disk" corresponds to devices cfdOsX and uses normal system 
memory. The device named "uramdisk" corresponds to dev- 
ices cfd2sX and uses the uncached portion of memory (if 
any). The uncached memory is slightly slower than normal 
system memory so is better suited for use as a RAM disk than 
as system memory. (There is also a device "tramdisk" 
corresponding to cfdl sX which is intended for use only by the 
System V installation procedure.) 

The RAM disk is used like any other disk device. Before being 
used, it should first be initialized with /V(1). 

For example, a description file named ramdisk.lM suitable for 
a RAM disk might be: 
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type 
name 



RD 

ramdlsk 



cyl inders 257 
heads 



1 



sectors 8 

$ 

$ 

$ 

0 

1 

129 $ 

$ 

$ 

The heads and sectors entries specify that each cylinder is 
4K. The cylinders entry specifies the number of 4K pages to 
be allocated for the RAM disk. In this example, 257 pages is 
one megabyte plus one page for the volume home block. The 
partition table is specified as for other disks [see /V(1)]. In this 
case, two partitions have been specified. The following com- 
mand would initialize the example RAM disk: 

iv - i /dev/rdsk/cfd2s0 ramdisk.lM 

After being initialized, a file system can be made on the RAM 
disk by mkfs (1M) and it can then be mounted and used. A bit 
map is not necessary for a RAM disk, so the -O flag should be 
used; 

mkfs /dev/rdsk/cfd2s1 -0 
mount /dev/dsk/cfd2sl /mnt 

For the uncached RAM disk (device 2), it might make sense to 
use a partition as a swap device. (For the normal RAM disk, 
device 0, this would not make sense, since normal system 
memory would be more useful as real memory than as a swap 
device). If a partition of the RAM disk is to be used as a swap 
device, do not make a file system on it, but just add it as a 
swap device after initializing with /V: 

swap -a /dev/dsk/cfd2s2 

The data written to a RAM disk remains in the RAM disk, even 
if the disk is unmounted, until the ramdisk driver is unloaded 
or the system is rebooted. The memory pages allocated to 
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the RAM disk similarly are not released until one of those two 
events occurs. 

SEE ALSO 

mkfs(1M) mount(lM) disk{7), 

lv(1) in the User's Reference Manual. 

WARNINGS 

Only one of the RAM disk drivers (ramdisk, uramdisk) may be 
loaded at any one time. 

If there is uncached memory on the system, it is by default 
used for system buffers. A "uramdisk" device appropriates 
some of these buffers for use by the RAM disk. If you create 
a very large RAM disk, so that there is not enough uncached 
memory left for system buffers, system performance may 
degrade. 
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NAME 

sa - devices administered by System Administration 
DESCRIPTION 

The files in the directories /dev/SA (for block devices) and the 
/dev/rSA (for raw devices) are used by System Administration 
to access the devices on which it operates. For devices that 
support more than one partition (like disks) the /dev/(r)SA 
entry is linked to the partition that spans the entire device. 
Not all /dev/{r)SA entries are used by all System Administra- 
tion commands. 

FILES 

/dev/SA 
/dev/rSA 
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NAME 

scpa - SCP active mode interface 

SYNOPSIS 

#include <sys/scp.h> 

DESCRIPTION 

The scpa driver provides loading and unloading functions for 
the Serial Communications Processor (SCP) board when run- 
ning in active mode. The open of device /dev/scpa fails if no 
active SCP boards are present or if they are already loaded. 
The only allowable function after opening the scpa device is to 
issue an ioctl call to download to the SCP boards. 

Three tunable parameters are passed to the driver from the 
/etc/master file. These parameters are: 

P1 The base I/O address for the first three SCP boards, 
specified as the value of the six address bits defined by 
DIP switch SW1 switches 1 to 6, where ON = 0 and OFF 
= 1 , with switch 6 corresponding to bit 0. 

P2 The base AT Bus memory address to be mapped to SCP 
shared memory. The 128K shared memory space of all 
active SCP boards is mapped contiguously, with the max- 
imum configuration of 5 boards requiring a 640K region. 
A value of 0 causes the boards to be mapped to the 
upper end of the 16MB AT Bus memory space, so that if 
N is the number of active SCP boards, the base address 
of shared memory space would be: 

OxFEOOOO - N * <0x20000) 

An out-of-range address or an address that does not 
allow enough room for all active SCP boards causes the 
initialization to return with an error. 

P3 The starting SCP board number (in the range 1 to 5) that 
is to be used in active mode. Values of this parameter 
other than 1 assume that the passive SCP driver has been 
loaded and will continue to support the lower numbered 
boards. 

A typical setting for the tunable parameters would be: 

oxio o 1 
for default SCP I/O addresses 0x500, 0x900, and OxCOO, 
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mapping to the upper range of AT Bus memory, and all 
boards active. 

The following command is supported via ioctl: 

SCPATTACH 

Download to all active SCP boards (as specified 
by the third tunable parameter); arg must point 
to an area in the caller's space where the first 4 
bytes are a count of the number of bytes to be 
loaded. The actual data must follow the count 
immediately. The count bytes are copied to each 
active SCP with the last byte aligned to the last 
byte of each 128K shared memory region. After 
loading, each active SCP is reset and begins exe- 
cution at location F000:FFF0 in its memory. 

SEE ALSO 

master (4) in the Programmer's Reference Manual. 
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NAME 

scsi - SCSI busses and peripherals 
DESCRIPTION 

The 6000/50 has a main internal SCSI bus (SCSI hostbus 
number 0) and supports external SCSI busses (SCSI hostbus 
numbers 1, 2, and so forth). Each of these busses is con- 
trolled by a host SCSI controller (WD33C93). The controller's 
SCSI ID is set to 7. 

On each SCSI hostbus, there are at most 7 target SCSI dev- 
ices attached. Each of these target devices has a unique 
SCSI ID (TARGETID 0 through 6) on each bus. 

Each target device can also have associated with it some 
optional configuration parameters [see scsicnfg (1M)]: 

PARITY If this parameter is specified, the target device 
supports parity on the SCSI bus. 

RESELECT This parameter specifies that the target device 
can disconnect from the SCSI bus while it is 
doing internal processing and reconnect to the 
bus when it is ready to continue sending or 
receiving data. 

SYNC If this parameter is specified, the target device 
uses synchronous protocol (as opposed to asyn- 
chronous protocol, the default). 

Each target SCSI device can support up to 8 attached drives. 
Each of these drives is assigned a unique logical unit number 
{LUN 0 through 7). 

Note that for must currently available target SCSI peripherals, 
there is only one logical unit, LUN (0). The 6000/50 currently 
supports two types of SCSI devices: disk and tape. 
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NAME 

streamio - STREAMS ioctl commands 

SYNOPSIS 

#inctude < stropts.h > 

int iocti {fildes, command, arg) 

int tildes, command; 

DESCRIPTION 

STREAMS [see intro{2)] ioctl commands are a subset of 
ioctl (2) system calls which perform a variety of control func- 
tions on streams. The arguments command and arg are 
passed to the file designated by fildes and are interpreted by 
the stream head. Certain combinations of these arguments 
may be passed to a module or driver in the stream. 

Fildes is an open file descriptor that refers to a stream. Com- 
mand determines the control function to be performed as 
described below, Arg represents additional information that is 
needed by this command. The type of arg depends upon the 
command, but it is generally an integer or a pointer to a 
command-specific data structure. 

Since these STREAMS commands are a subset of ioctl, they 
are subject to the errors described there. In addition to those 
errors, the call will fail with errno set to EINVAL, without pro- 
cessing a control function, if the stream referenced by fildes is 
linked below a multiplexor, or if command is not a valid value 
for a stream. 

Also, as described in ioctl, STREAMS modules and drivers can 
detect errors. In this case, the module or driver sends an 
error message to the stream head containing an error value. 
This causes subsequent system calls to fail with errno set to 
this value. 

COMMAND FUNCTIONS 

The following ioctl commands, with error values indicated, are 
applicable to all STREAMS files: 
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I_PUSH 

Pushes the module whose name is pointed to by arg onto 
the top of the current stream , just below the stream head. 
It then calls the open routine of the newly-pushed 
module. On failure, errno is set to one of the following 
values: 

[BNVAL] Invalid module name. 

[EFAULT] Arg points outside the allocated address 
space. 

[ENXIO] Open routine of new module failed. 
[ENXIO] Hangup received on tildes. 
IJPOP 

Removes the module just below the stream head of the 
stream pointed to by fildes. Arg should be 0 in an 
I_POP request. On failure, errno is set to one of the fol- 
lowing values: 

[E1NVAL] No module present in the stream. 
[ENXIO] Hangup received on fildes. 
I_LOOK 

Retrieves the name of the module just below the stream 
head of the stream pointed to by fildes, and places it in 
a null terminated character string pointed at by arg. 
The buffer pointed to by arg should be at least 
FMNAMESZ+1 bytes long. A "#include 
<sys/conf.h>" declaration is required. On failure, 
errno is set to one of the following values: 

[EFAULT] Arg points outside the allocated address 
space. 

[EINVAL] No module present in stream. 
IJFLUSH 

This request flushes all input and/or output queues, 
depending on the value of arg. Legal arg values are: 

FLUSHR Flush read queues. 

FLUSHW Flush write queues. 

FLUSHRW Flush read and write queues. 
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On failure, errno is set to one of the following values: 

[EAGAIN] Unable to allocate buffers for flush mes- 
sage. 

[EINVAL] Invalid arg value. 
[ENXIOJ Hangup received on fildes. 
I_SETSIG 

Informs the stream head that the user wishes the kernel 
to issue the SIGPOLL signal [see signal (2) and s/g- 
sef(2)J when a particular event has occurred on the 
stream associated with f/7des. I_SETSIG supports an 
asynchronous processing capability in STREAMS. The 
value of arg is a bitmask that specifies the events for 
which the user should be signaled. It is the bitwise-OR 
of any combination of the following constants: 

SJNPUT A non-priority message has arrived on a 
stream head read queue, and no other 
messages existed on that queue before 
this message was placed there. This is 
set even if the message is of zero length. 

S_HIPRI A priority message is present on the 
stream head read queue. This is set even 
if the message is of zero length. 

S_OUTPUT The write queue just below the stream 
head is no longer full. This notifies the 
user that there is room on the queue for 
sending (or writing) data downstream. 

S_MSG A STREAMS signal message that contains 
the SIGPOLL signal has reached the front 
of the stream head read queue. 

A user process may choose to be signaled only of prior- 
ity messages by setting the arg bitmask to the value 
S_HIPRI. 

Processes that wish to receive SIGPOLL signals must 
explicitly register to receive them using I_SETSIG. If 
several processes register to receive this signal for, the 
same event on the same Stream, each process will be 
signaled when the event occurs. 
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If the value of arg is zero, the calling process will be 
unregistered and will not receive further SIGPOLL sig- 
nals. On failure, errno is set to one of the following 
values: 

[EINVAL] Arg value is invalid or arg is zero and pro- 
cess is not registered to receive the SIG- 
POLL signal. 

[EAGAIN] Allocation of a data structure to store the 
signal request failed. 

IJ3ETSIG 

Returns the events for which the calling process is 
currently registered to be sent a SIGPOLL signal. The 
events are returned as a bitmask pointed to by arg, 
where the events are those specified in the description 
of I_SETSIG above. On failure, errno is set to one of 
the following values: 

[EINVAL j Process not registered to receive the SIG- 
POLL signal. 

[EFAULTj Arg points outside the allocated address 
space. 

IJFIND 

This request compares the names of all modules 
currently present in the stream to the name pointed to 
by arg t and returns 1 if the named module is present in 
the stream. It returns 0 if the named module is not 
present. On failure, errno is set to one of the following 
values: 

[EFAULT] Arg points outside the allocated address 
space. 

{QNVAL] Arg does not contain a valid module 
name. 

I_PEEK 

This request allows a user to retrieve the information in 
the first message on the stream head read queue 
without taking the message off the queue. Arg points 
to a strpeek structure which contains the following 
members: 
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struct strbuf ctlbuf; 
struct strbuf databuf ; 

long flags; 

The maxlen field in the ctlbuf and databuf strbuf struc- 
tures [see getmsg{2)] must be set to. the number of 
bytes of control information and/or data information, 
respectively, to retrieve. If the user sets flags to 
RS_HIPRI, I_PEEK will only look for a priority message 
on the stream head read queue. 

I_PEEK returns 1 if a message was retrieved, and 
returns 0 if no message was found on the stream head 
read queue, or if the RSJHIPR1 flag was set in flags 
and a priority message was not present on the stream 
head read queue. It does not wait for a message to 
arrive. On return, ctlbuf specifies information in the 
control buffer, databuf specifies information in the data 
buffer, and flags contains the value 0 or RSJ-UPRI, On 
failure, errno is set to the^ following value: 

[EFAULT] Arg points, or the buffer area specified in 
ctlbuf or databuf is, outside the allocated 
address space. 

I_SRDOPT 

v Sets the read mode using the value of the argument 
arg. Legal arg values are: 

RNORM Byte-stream mode, the default. 

RMSGD Message-discard mode. 

RMSGN Message-nondiscard mode. 

Read modes are described in read (2). On failure, errno 
is set to the following value: 

[EINVAL] Arg is not one of the above legal values. 
LGRDOPT 

Returns the current read mode setting in an int pointed 
to by the argument arg. Read modes are described in 
read (2). On failure, errno is set to the following value: 

[EFAULT] Arg points outside the allocated address 
space. 
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I_NREAD 

Counts the number of data bytes in data blocks in the 
first message on the stream head read queue, and 
places this value in the location pointed to by arg. The 
return value for the command is the number of mes- 
sages on the stream head read queue. For example, if 
zero is returned in arg, but the ioctl return value is 
greater than zero, this indicates that a zero-length mes- 
sage is next on the queue. On failure, errno is set to 
the following value: 

[EFAULT] Arg points outside the allocated address 
space. 

I_FDINSERT 

Creates a message from user specified buffer(s), adds 
information about another stream and sends the mes- 
sage downstream. The message contains a control part 
and an optional data part. The data and control parts 
to be sent are distinguished by placement in separate 
buffers, as described below. 

Arg points to a strfdinsert structure which contains the 
following members; 

struct strbuf ctlbuf; 
struct strbuf databuf; 
long flags; 
int fd; 
int offset; 

The ten field in the ctlbuf strbuf structure [see 
putmsg(2)] must be set to the size of a pointer plus the 
number of bytes of control information to be sent with 
the message. Fd specifies the file descriptor of the 
other stream and offset , which must be word-aligned, 
specifies the number of bytes beyond the beginning of 
the control buffer where I__FDINSERT will store a pointer 
to the fd stream's driver read queue structure. The len 
field in the databuf strbuf structure must be set to the 
number of bytes of data information to be sent with the 
message or zero if no data part is to be sent. 

Flags specifies the type of message to be created. A 
non- priority message is created if flags is set to 0, and 
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a priority message is created if flags is set to RS_HIPRI. 
For non- priority messages, I__FDINSERT will block if the 
stream write queue is full due to internal flow control 
conditions. For priority messages, I_FDINSERT does 
not block on this condition. For non-priority messages, 
IFDINSERT does not block when the write queue is full 
and O NDELAY is set. Instead, it fails and sets errno to 
EAGAIN. 

I FDINSERT also blocks, unless prevented by lack of 
internal resources, waiting for the availability of mes- 
sage blocks in the stream, regardless of priority or 
whether 0_NDELAY has been specified. No partial 
message is sent. On failure, errno is set to one of the 
following values: 

[EAGAIN] A non-priority message was specified, the 
O^NDELAY flag is set, and the stream 
write queue is full due to internal flow 
control conditions. 

[EAGAIN] Buffers could not be allocated for the 
message that was to be created. 

[EFAULTj Arg points outside the allocated address 
space, or the buffer area specified in 
ctlbuf or databuf is outside the allocated 
address space. 

[BNVAL] One of the following: fd in the strfdinsert 
structure is not a valid, open stream file 
descriptor; the size of a pointer plus 
offset is greater than the ten field for the 
buffer specified through ctlptr, offset 
does not specify a properly-aligned loca- 
tion in the data buffer; an undefined value 
is stored in flags, 

[ENXIO] Hangup received on //Votes. 

[ERANGE] The /en field for the buffer specified 
through databuf does not fall within the 
range specified by the maximum and 
minimum packet sizes of the topmost 
stream module, or the len field for the 
buffer specified through databuf is larger 
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than the maximum configured size of the 
data part of a message, or the len field 
for the buffer specified through ctlbuf is 
larger than the maximum configured size 
of the control part of a message. 

I_STR Constructs an internal STREAMS ioctl message from 
the data pointed to by arg, and sends that message 
downstream. 

This mechanism is provided to send user ioctl requests 
to downstream modules and drivers. It allows informa- 
tion to be sent with the ioctl, and will return to the user 
any information sent upstream by the downstream reci- 
pient. I_STR blocks until the system responds with 
either a positive or negative acknowledgement mes- 
sage, or until the request "times out" after some period 
of time. If the request times out, it fails with errno set 
to ETIME. 

At most, one I_STR can be active on a stream. Further 
I_STR calls will block until the active I_STR completes at 
the stream head . The default timeout interval for these 
requests is 15 seconds. The 0_NDELAY [see open (2)] 
flag has no effect on this call. 

To send requests downstream, arg must point to a 
strioctl structure which contains the following members; 

int ic_cmd; /* downstream conmand */ 
int ic_tfmout; /* ACK/NAK timeout */ 
int icjen; /* length of data arg */ 
char *ic_dp; /* ptr to data arg */ 

Ic_cmd is the internal ioctl command intended for a 
downstream module or driver and icjimout is the 
number of seconds (-1 = infinite, 0 = use default, >0 
= as specified) an I_STR request will wait for ack- 
nowledgement before timing out. Icjen is the number 
of bytes in the data argument and ic_dp is a pointer to 
the data argument. The icjen field has two uses: on 
input, it contains the length of the data argument 
passed in, and on return from the command, it contains 
the number of bytes being returned to the user (the 
buffer pointed to by ic_dp should be large enough to 
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contain the maximum amount of data that any module 
or the driver in the stream can return). 

The stream head will convert the information pointed to 
by the strioctl structure to an internal iocti command 
message and send it downstream. On failure, errno is 
set to one of the following values: 

[EAGAIN] Unable to allocate buffers for the ioct! 
message. 

[EFAULT] Arg points, or the buffer area specified by 
ic_dp and icjen (separately for data sent 
and data returned) is, outside the allo- 
cated address space. 

[EINVAL] Jcjen is less than 0 or icjen is larger 
than the maximum configured size of the 
data part of a message or icjimout is 
less than -1. 

[ENXIO] Hangup received on fildes. 

[ETIME] A downstream ioctl timed out before ack- 
nowledgement was received. 

An I_STR can also fail while waiting for an acknowledge- 
ment if a message indicating an error or a hangup is 
received at the stream head. In addition, an error code 
can be returned in the positive or negative ack- 
nowledgement message, in the event the ioctl com- 
mand sent downstream fails. For these cases, I_STR 
will fail with errno set to the value in the message. 

I_SENDFD 

Requests the stream associated with fildes to send a 
message, containing a file pointer, to the stream head 
at the other end of a stream pipe. The file pointer 
corresponds to arg, which must be an integer file 
descriptor. 

I_SENDFD converts arg into the corresponding system 
file pointer. It allocates a message block and inserts 
the file pointer in the block. The user ID and group ID 
associated with the sending process are also inserted. 
This message is placed directly on the read queue [see 
intro{2)] of the stream head at the other end of the 
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stream pipe to which it is connected. On failure, errno 
is set to one of the following values: 

[EAGA1N] The sending stream is unable to allocate a 
message block to contain the file pointer. 

[EAGAIN] The read queue of the receiving stream 
head is full and cannot accept the mes- 
sage sent by I_SENDFD. 

[EBADF] Arg is not a valid, open file descriptor. 

[BNVAL] Fildes is not connected to a stream pipe. 

[ENXIO] Hangup received on fildes. 

I_RECVFD 

Retrieves the file descriptor associated with the mes- 
sage sent by an I_SENDFD ioctl over a stream pipe. 
Arg is a pointer to a data buffer large enough to hold 
an strrecvfd data structure containing the following 
members: 

int fd; 

unsigned short uid; 
unsigned short gid; 
char fill 18]; 

Fd is an integer file descriptor. Uid and gid are the 
user ID and group ID, respectively, of the sending 
stream. 

If 0_NDELAY is not set [see open(2)], I_RECVFD will 
block until a message is present at the sfream head. If 
0_NDELAY is set, I_RECVFD will fail with errno set to 
EAGAIN if no message is present at the stream head. 

If the message at the stream head is a message sent 
by an I__SENDFD, a new user file descriptor is allocated 
for thelile pointer contained in the message. The new 
file descriptor is placed in the fd field of the strrecvfd 
structure. The structure is copied into the user data 
buffer pointed to by arg. On failure, errno is set to one 
of the following values: 



Page 10 



UP-13529 



STREAMIO(7) 



[EAGAIN] A message was not present at the stream 
head read queue, and the 0_NDELAY 
flag is set. 

[EBADMSG] The message at the stream head read 
queue was not a message containing a 
passed file descriptor. 

[EFAULT] Arg points outside the allocated address 
space. 

[EMFILE] NOFILES file descriptors are currently 
open. 

[ENXIO] Hangup received on tildes. 

The following two commands are used for connecting and 
disconnecting multiplexed STREAMS configurations. 

IJJNK 

Connects two streams, where fitdes is the file descriptor 
of the stream connected to the multiplexing driver, and 
arg is the file descriptor of the sfream connected to 
another driver. The stream designated by arg gets con- 
nected below the multiplexing driver. I^LINK requires the 
multiplexing driver to send an acknowledgement message 
to the stream head regarding the linking operation. This 
call returns a multiplexor ID number (an identifier used to 
disconnect the multiplexor, see I_UNUNK) on success, 
and a -1 on failure. On failure, errno is set to one of the 
following values: 

[ENXIO] Hangup received on tildes. 

[ETIME] Time out before acknowledgement message 
was received at stream head. 

[EAGAIN] Unable to allocate STREAMS storage to per- 
form the IJJNK. 

[EBADF] Arg is not a valid, open file descriptor. 

[EINVAL] Fildes stream does not support multiplex- 
ing. 

[EINVAL] Arg is not a stream, or is already linked 
under a multiplexor. 
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[BNVAL] The specified link operation would cause a 
"cycle" in the resulting configuration; that 
is, if a given stream head is linked into a 
multiplexing configuration in more than one 
place. 

An I_LINK can also fail while waiting for the multiplexing 
driver to acknowledge the link request, if a message indi- 
cating an error or a hangup is received at the stream 
head of fildes. In addition, an error code can be returned 
in the positive or negative acknowledgement message. 
For these cases, I_LINK will fail with errno set to the value 
in the message. 

IJJNLINK 

Disconnects the two streams specified by fildes and 
arg. Fildes is the file descriptor of the stream con- 
nected to the multiplexing driver. Arg is the multiplexor 
ID number that was returned by the ioctl I_UNK com- 
mand when a stream was linked below the multiplexing 
driver. If arg is -1, then all Streams which were linked 
to fildes are disconnected. As in I_LINK, this command 
requires the multiplexing driver to acknowledge the 
unlink. On failure, errno is set to one of the following 
values: 

[ENXIO] Hangup received on fildes. 

[ETIME] Time out before acknowledgement mes- 
sage was received at stream head. 

[EAGAIN] Unable to allocate buffers for the ack- 
nowledgement message. 

[EINVAL] Invalid multiplexor ID number. 

An I_UNLIIMK can also fail while waiting for the multi- 
plexing driver to acknowledge the link request, if a mes- 
sage indicating an error or a hangup is received at the 
stream head of fildes. In addition, an error code can 
be returned in the positive or negative acknowledge- 
ment message. For these cases, IJJNLINK will fail with 
errno set to the value in the message. 

SEE ALSO 

ciose(2), fcntl{2), intro(2), ioctl(2), open(2), read(2), getmsg(2), 
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poll (2), putmsg(2), signal (2), sigset{2), write(2) in the 
Programmer's Reference Manual, 

System V Operating System STREAMS Programmer's Guide. 
System V Operating System STREAMS Primer. 

DIAGNOSTICS 

Unless specified otherwise above, the return value from ioctl is 
0 upon success and -1 upon failure with errno set as indi- 
cated. 
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NAME 

sxt - pseudo- device driver 

DESCRIPTION 

The special file /dev/sxt is a pseudo-device driver that inter- 
poses a discipline between the standard try line disciplines and 
a real device driver. The standard disciplines manipulate vir- 
tual tty structures (channels) declared by the /dev/sxt driver. 
/Dev/sxt acts as a discipline manipulating a real tty structure 
declared by a real device driver. The /dev/sxt driver is 
currently only used by the shl{\) command. 

Virtual ttys are named by i-nodes in the subdirectory /dev/sxt 
and are allocated in groups of up to eight. To allocate a 
group, a program should exclusively open a file with a name 
of the form /dev/sxt/??0 (channel 0) and then execute a 
SxmOCLINK ioctl call to initiate the multiplexing. 

Only one channel, the controlling channel, can receive input 
from the keyboard at a time; others attempting to read will be 
blocked. 

There are two groups of ioctl (2) commands supported by sxt. 
The first group contains the standard ioctl commands 
described in termio{7) t with the addition of the following: 

TIOCEXCL 

Set exclusive use mode: no further opens are permitted 
until the file has been closed. 

TIOCNXCL 

Reset exclusive use mode: further opens are once again 
permitted. 

The second group are commands to sxf itself. Some of these 
may only be executed on channel 0. 

SXTIOCLINK 

Allocate a channel group and multiplex the virtual ttys 
onto the real tty. The argument is the number of chan- 
nels to allocate. This command may only be executed on 
channel 0. Possible errors include: 

EINVAL The argument is out of range. 

ENOTTY The command was not issued from a real tty. 
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ENX10 Linesw is not configured with sxt . 

EBUSY An SXTIOCLINK command has already been 
issued for this real tty. 

ENOMEM There is no system memory available for allo- 
cating the virtual tty structures. 

EBADF Channel 0 was not opened before this call. 

SXTIOCSWTCH 

Set the controlling channel. Possible errors include: 

EINVAL An invalid channel number was given. 

EPERM The command was not executed from 
channel 0. 

SXTIOCWF 

Cause a channel to wait until it is the controlling chan- 
nel. This command will return the error EINVAL if an 
invalid channel number is given. 

SXTIOCUBLK 

Turn off the loblk control flag in the virtual tty of the 
indicated channel. The error EINVAL will be returned if 
an invalid number or channel 0 is given. 

SXTIOCSTAT 

Get the status {blocked on input or output) of each 
channel and store in the sxtbtock structure referenced 
by the argument. The error EFAULT will be returned if 
the structure cannot be written. 

SXTIOCTRACE 

Enable tracing. Tracing information is written to 
/dev/asm on the 6000/50. This command has no effect 
if tracing is not configured. 

SXTIOCNOTRACE 

Disable tracing. This command has no effect if tracing 
is not configured. 

FILES 

/dev/sxt/??[0-7] Virtual tty devices 

/usr/include/sys/sxt.h Driver specific definitions 

SEE ALSO 

termio(7). 
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shl(1), stty(1) in the User's Reference Manual. 

ioctl(2), open(2) in the Programmer's Reference Manual. 
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NAME 

termio - general terminal interface 
DESCRIPTION 

AH of the asynchronous communications ports use the same 
general interface, no matter what hardware is involved. The 
remainder of this section discusses the common features of 
this interface. 

When a terminal file is opened, it normally causes the process 
to wait until a connection is established. In practice, users' 
programs seldom open terminal files; they are opened by 
getty and become a user's standard input, output, and error 
files. The very first terminal file opened by the process group 
leader of a terminal file not already associated with a process 
group becomes the control terminal for that process group. 
The control terminal plays a special role in handling quit and 
interrupt signals, as discussed below. The control terminal is 
inherited by a child process during a fork {2). A process can 
break this association by changing its process group using 
sefpgrp(2). 

A terminal associated with one of these files ordinarily 
operates in full-duplex mode. Characters may be typed at 
any time, even while output is occurring, and are only lost 
when the system's character input buffers become completely 
full, which is rare, or when the user has accumulated the max- 
imum allowed number of input characters that have not yet 
been read by some program. Currently, this limit is 256 char- 
acters. When the input limit is reached, the buffer is flushed 
and all the saved characters are thrown away without notice. 

Normally, terminal input is processed in units of lines, A line is 
delimited by a new-line (ASCII LF) character, an end-of-file 
(ASCII EOT) character, or an end-of-line character. This 
means that a program attempting to read will be suspended 
until an entire line has been typed. Also, no matter how many 
characters are requested in the read call, at most one line will 
be returned. It is not, however, necessary to read a whole line 
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at once; any number of characters may be requested in a 
read, even one, without losing information. 

During input, erase and kill processing is normally done. By 
default, the character generated by a BACK SPACE key 
(ASCII BS, Control-H on most terminals) erases the last char- 
acter typed, except that it will not erase beyond the beginning 
of the line. By default, the character *U (Control-U) kills 
(deletes) the entire input line, and optionally outputs a new- 
line character. Both these characters operate on a key-stroke 
basis, independently of any backspacing or tabbing that may 
have been done. Both the erase and kill characters may be 
entered literally by preceding them with the escape character 
(\). In this case the escape character is not read. The erase 
and kill characters may be changed. 

Certain characters have special functions on input. These 
functions and their default character values are summarized 
as follows: 

INTR (Controi-C) generates an interrupt signal which is sent 
to all processes with the associated control terminal. 
Normally, each such process is forced to terminate, 
but arrangements may be made either to ignore the 
signal or to receive a trap to an agreed-upon location; 
see signal (2). 

QUIT (Control- j or ASCII FS) generates a quit signal. Its 
treatment is identical to the interrupt signal except 
that, unless a receiving process has made other 
arrangements, it will not only be terminated but a 
core image file (called core) will be created in the 
current working directory. 

SWTCH (Control-z or ASCII SUB) is used by the job control 
facility, shl, to change the current layer to the control 
layer. 

ERASE (Control-H or ASCII BS) erases the preceding charac- 
ter. It wilt not erase beyond the start of a line, as del- 
imited by a NL, EOF, or EOL character. 

KILL (@) deletes the entire line, as delimited by a NL, EOF, 
or EOL character. 
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EOF (Controi-D or ASCII EOT) may be used to generate 
an end-of-file from a terminal. When received, all the 
characters waiting to be read are immediately passed 
to the program, without waiting for a new-line, and 
the EOF is discarded. Thus, if there are no charac- 
ters waiting, which is to say the EOF occurred at the 
beginning of a line, zero characters will be passed 
back, which is the standard end-of-file indication. 

NL {ASCII LF) is the normal line delimiter. It can not be 
changed or escaped. 

EOL (ASCII NUL) is an additional line delimiter; like NL It 
is not normally used. 

EOL2 is another additional line delimiter. 

STOP (Control-s or ASCII DC3) can be used to temporarily 
suspend output. It is useful with CRT terminals to 
prevent output from disappearing before it can be 
read. While output is suspended, STOP characters 
are ignored and not read. 

START (Control-q or ASCII DC1) is used to resume output 
which has been suspended by a STOP character. 
While output is not suspended, START characters are 
ignored and not read. The start/stop characters can 
not be changed or escaped. 

The character values for INTR, QUIT, SWTCH, ERASE, KILL, 
EOF, and EOL may be changed to suit individual tastes. The 
ERASE, KILL, and EOF characters may be escaped by a 
preceding \ character, in which case no special function is 
done. 

When the carrier signal from the data-set drops, a hang-up 
signal is sent to all processes that have this terminal as the 
control terminal. Unless other arrangements have been made, 
this signal causes the processes to terminate. If the hang-up 
signal is ignored, any subsequent read returns with an end- 
of-file indication. Thus, programs that read a terminal and 
test for end-of-file can terminate appropriately when hung up 
on. 

When one or more characters are written, they are transmitted 
to the terminal as soon as previously- written characters have 
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finished typing. Input characters are echoed by putting them 
in the output queue as they arrive. If a process produces 
characters more rapidly than they can be typed, it will be 
suspended when its output queue exceeds some limit. When 
the queue has drained down to some threshold, the program 
is resumed. 

Several ioctf(2) system calls apply to terminal files. The pri- 
mary calls use the following structure, defined in <termio.h>: 



#define NCC 
struct 



8 



termfo \ 

unsigned short c_iflag; 

unsigned short c_oflag; 

unsigned short c_cflag; 

unsigned short c__lf1agj 

char c_l ine; 

unsigned char c_cc[NCC]j 



/* input modes */ 
/* output modes */ 
control modes */ 
local modes */ 
line discipline */ 
control chars */ 



/* 
/* 
/* 



The special control characters are defined by the array c cc. 
The relative positions and initial values for each function are as 
follows: 



0 


V1NTR 


ETX 


1 


VQU1T 


FS 




VERASE 


BS 


3 


WILL 


ETX 




VEOF 


EOT 


5 


VEOL 


NUL 


6 


reserved 




7 


VSWTCH 


NUL 


The cjflag field describes the basic terminal input contn 


IGNBRK 


0000001 


Ignore break condition. 


BRKINT 


0000002 


Signal interrupt on break. 


IGNPAR 


0000001 


Ignore characters with parity errors. 


PARMRK 


0000010 


Mark parity errors. 


INPCK 


0000020 


Enable input parity check. 


I STRIP 


0000040 


Strip character. 


INLCR 


0000100 


Map NL to CR on input. 


1GNCR 


0000200 


Ignore CR. 


I CRM. 


0000400 


Map CR to NL on input. 


IUCLC 


0001000 


Map upper- case to lower-case on input. 
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IXON 0002000 Enable start/stop output control. 
IXANY 0001000 Enable any character to restart output. 
IXOFF 0010000 Enable start/stop input control. 
IPCMODE 0020000 PC terminal mode 

If IGNBRK is set, the break condition (a character framing 
error with data all zeros) is ignored, that is, not put on the 
input queue and therefore not read by any process. Other- 
wise if BRKINT is set, the break condition will generate an 
interrupt signal and flush both the input and output queues. If 
IGNPAR is set, characters with other framing and parity errors 
are ignored. 

If PARMRK is set, a character with a framing or parity error 
which is not ignored is read as the three-character sequence: 
0377, 0, X, where X is the data of the character received in 
error. To avoid ambiguity in this case, if ISTRIP is not set, a 
valid character of 0377 is read as 0377, 0377. If PARMRK is 
not set, a framing or parity error which is not ignored is read 
as the character NUL (0). 

If INPCK is set, input parity checking is enabled. If INPCK is 
not set, input parity checking is disabled. This allows output 
parity generation without input parity errors. 

If ISTRIP is set, valid input characters are first stripped to 7- 
bits, otherwise all 8-bits are processed. 

If INLCR is set, a received NL character is translated into a CR 
character. If IGNCR is set, a received CR character is ignored 
(not read). Otherwise if ICRNL is set, a received CR character 
is translated into a NL character. 

If IUCLC is set, a received upper-case alphabetic character is 
translated into the corresponding lower-case character. 

If IXON is set, start/stop output control is enabled. A received 
STOP character will suspend output and a received START 
character will restart output. All start/stop characters are 
ignored and not read. If IXANY is set, any input character, will 
restart output which has been suspended. 

If IXOFF is set, the system will transmit START/STOP charac- 
ters when the input queue is nearly empty/full. 

The initial input control value is all-bits-clear. 
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If IPCMODE is set, the terminal is assumed to send IBM PC- 
compatible scan codes rather than ASCII codes. The system 
will convert the scan codes to ASCII on input. This works only 
if the optional software has been installed (see the User's 
Manual). 

The c_pflag field specifies the system treatment of output: 



OPOST 


0000001 

WWW 1 


PostnroceSK out nut 


OLCUC 


0000002 


Map lower case to upper on output. 


ONLCR 


0000001 


Map NL to CR-NL on output. 


OCRNL 


0000010 


Map CR to NL on output. 


ONOCR 


0000020 


No CR output at column 0. 


ONI RFT 


0000040 


NL performs CR function. 


Op ILL 


0000100 


Use fill characters for delay. 


OFDEL 


0000200 


Fill is DEL else NUL 

» «-» I/lain, f ** » SJW IWL * 


NLDLY 


0000100 


Select new- 1 ine delays: 


NLO 


o 




NL1 


0000400 




CRDLY 


0003000 


Select carriaae- return delavs: 


CRO 


o 




CR1 


0001000 




CR2 


0002000 




CR3 


0003000 




TABDLY 


001 4000 


Select horizontal- tab delays: 


TARO 
IMDv 


o 




TAB1 


0004000 




TAB2 


0010000 




TAB3 


0014000 


Expand tabs to spaces. 


BSDLY 


0020000 


Select backspace delays: 


BSO 


0 




BS1 


0020000 




VTOLY 


0040000 


Select vertical- tab delays: 


VTO 


0 




VT1 


0040000 




FFDLY 


0100000 


Select form- feed delays: 


FFO 


0 




FF1 


0100000 





If OPOST is set, output characters are post- processed as indi- 
cated by the remaining flags, otherwise characters are 
transmitted without change. 
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H OLCUC is set, a lower-case alphabetic character is transmit- 
ted as the corresponding upper-case character. This function 
is often used in conjunction with IUCLC. 

If ONLCR is set, the NL character is transmitted as the CR-NL 
character pair. If OCRNL is set, the CR character is transmit- 
ted as the NL character. If ONOCR is set, no CR character is 
transmitted when at column 0 (first position). If ONLRET is 
set, the NL character is assumed to do the carriage- return 
function; the column pointer will be set to 0 and the delays 
specified for CR will be used. Otherwise the NL character is 
assumed to do just the line-feed function; the column pointer 
will remain unchanged. The column pointer is also set to 0 if 
the CR character is actually transmitted. 

The delay bits specify how long transmission stops to allow for 
mechanical or other movement when certain characters are 
sent to the terminal. In all cases a value of 0 indicates no 
delay. If OFILL is set, fill characters will be transmitted for 
delay instead of a timed delay. This is useful for high baud 
rate terminals which need only a minimal delay. If OFDEL is 
set, the fill character is DEL, otherwise NUL. 

If a form-feed or vertical-tab delay is specified, it lasts for 
about 2 seconds. 

New-line delay lasts about 0.10 seconds. If ONLRET is set, 
the carriage-return delays are used instead of the new-line 
delays. If OFILL is set, two fill characters will be transmitted. 

Carriage- return delay type 1 is dependent on the current 
column position, type 2 is about 0.10 seconds, and type 3 is 
about 0.15 seconds. If OFILL is set, delay type 1 transmits 
two fill characters, and type 2, four fill characters. 

Horizontal-tab delay type 1 is dependent on the current 
column position. Type 2 is about 0.10 seconds. Type 3 speci- 
fies that tabs are to be expanded into spaces. If OFILL is set, 
two fill characters will be transmitted for any delay. 

Backspace delay lasts about 0.05 seconds. If OFILL is set, 
one fill character will be transmitted. 

The actual delays depend on line speed and system load. 

The initial output control value is all bits clear. 
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The c_cflag field describes the. hardware control of the termi- 
nal; 



CBAUD 


0000017 


Baud rate; 


BO 


0 


Hang up 


B50 


0000001 


50 baud 


B75 


0000002 


75 baud 


B110 


0000003 


110 baud 


B134 


0000004 


134 baud 


B150 


0000005 


150 baud 


B200 


0000006 


200 baud 


B300 


0000007 


300 baud 


B600 


0000010 


600 baud 


B1200 


0000011 


1200 baud 


B1800 


0000012 


1800 baud 


B2400 


0000013 


2400 baud 


B4800 


0000014 


4800 baud 


B9600 


0000015 


9600 baud 


B19200 


0000016 


19200 baud 


B38400 


0000017 


38400 baud 


CSIZE 


0000060 


Character size: 


CSS 


0 


5 bits 


CS6 


0000020 


6 bits 


CS7 


ooooouo 


7 bits 


CS8 


0000060 


8 bits 


CSTOPB 


0000100 


Send two stop bits, else one. 


CREAD 


0000200 


Enable receiver. 


PARENB 


0000400 


Parity enable. 


PARODD 


0001000 


Odd parity, else even. 


HUPCL 


0002000 


Hang up on last close. 


CLOCAL 


ooonooo 


Local line, else dial-up. 


LOBLK 


0040000 


Block layer output. 


CTSCO 


0100000 


CTS hardware handshaking. 



The CBAUD bits specify the baud rate. The zero baud rate, 
BO, is used to hang up the connection. If BO is specified, the 
data-terminal- ready signal will not be asserted. Normally, this 
will disconnect the line. For any particular hardware, impossi- 
ble speed changes are ignored. 

The CSIZE bits specify the character size in bits for both 
transmission and reception. This size does not include the 
parity bit, if any. If CSTOPB is set, two stop bits are used, 
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otherwise one stop bit. For example, at 110 baud, two stops 
bits are required. 

If PARENB is set, parity generation and detection is enabled 
and a parity bit is added to each character. If parity is 
enabled, the PARODD flag specifies odd parity if set, other- 
wise even parity is used. 

If CREAD is set, the receiver is enabled. Otherwise no charac- 
ters will be received. 

If HUPCL is set, the line will be disconnected when the last 
process with the line open closes it or terminates. That is, the 
data-terminal- ready signal will not be asserted. 

If CLOCAL is set, the line is assumed to be a local, direct con- 
nection with no modem control. Otherwise modem control is 
assumed. 

If LOBLK is set, the output of a job control layer will be 
blocked when it is not the current layer. Otherwise the output 
generated by that layer will be multiplexed onto the current 
layer. 

If CTSCD is set, hardware handshaking is enabled using CTS 
(clear to send) and RTS (request to send). This feature does 
not work on IBM AT compatible ports. 

The initial hardware control value after open is B9600, CS8, 
CREAD, HUPCL. 

The cjflag field of the argument structure is used by the line 
discipline to control terminal functions. The basic line discip- 
line (0) provides the following: 



ISIG 


0000001 


Enable signals. 


I CANON 


0000002 


Canonical input (erase and kill processing). 


XCASE 


0000001 


Canonical upper/ lower presentation. 


ECHO 


0000010 


Enable echo. 


ECHOE 


0000020 


Echo erase character as BS-SP-BS. 


ECHOK 


0000010 


Echo NL after kill character. 


ECHONL 


0000100 


Echo NL. 


NOFLSH 


0000200 


Disable flush after interrupt or quit. 



If ISIG is set, each input character is checked against the spe- 
cial control characters INTR, SWTCH, and QUIT. If an input 
character matches one of these control characters, the 
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function associated with that character is performed. If IS1G is 
not set, no checking is done. Thus these special input func- 
tions are possible only if ISIG is set. These functions may be 
disabled individually by changing the value of the control char- 
acter to an unlikely or impossible value (for example, 0377). 

If ICANON is set, canonical processing is enabled. This 
enables the erase and kill edit functions, and the assembly of 
input characters into lines delimited by NL, EOF, and EOL If 
ICANON is not set, read requests are satisfied directly from 
the input queue. The values of VMIN and VT1ME control how 
many and when characters are returned. If both are 0, reads 
come back immediately if no characters are present. If VMIN 
is greater than 0 and VTIME is equal to 0, the read will wait 
until at least VMIN characters have been received. If VMIN is 
equal to 0 and VTIME is greater than 0, the read will return 
after VTIME tenths of a second, regardless of whether any 
characters have been received. Note that in this case a read 
may return 0, which is indistinguishable from end-of-file. If is 
greater than 0 and VTIME is greater than 0, the timeout period 
starts after the first character has been received; thus a read 
will always return greater than or equal to 1 . This allows fast 
bursts of input to be read efficiently while still allowing single 
character input. The MIN and TIME values are stored in the 
position for the EOF and EOL characters, respectively. The 
time value represents tenths of seconds. 

If XCASE is set, and if ICANON is set, an upper-case letter is 
accepted on input by preceding it with a \ character, and is 
output preceded by a \ character. In this mode, the following 
escape sequences are generated on output and accepted on 
input: 

for: use : 
* V 
! V. 

" r 
{ M 
} \) 

\ w 

For example, A is input as \a, \n as \\n, and \N as \\\n. 
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If ECHO is set, characters are echoed as received. 

When 1CANON is set, the following echo functions are possi- 
ble. If ECHO and ECHOE are set, the erase character is 
echoed as ASCII BS SP BS, which will clear the last character 
from a CRT screen. If ECHOE is set and ECHO is not set, the 
erase character is echoed as ASCII SP BS. If ECHOK is set, 
the NL character will be echoed after the kill character to 
emphasize that the line will be deleted. Note that an escape 
character preceding the erase or kill character removes any 
special function. If ECHONL is set, the NL character will be 
echoed even if ECHO is not set. This is useful for terminals 
set to local echo (so-called half duplex). Unless escaped, the 
EOF character is not echoed. Because EOT is the default 
EOF character, this prevents terminals that respond to EOT 
from hanging up. 

If NOFLSH is set, the normal flush of the input and output 
queues associated with the quit, switch, and interrupt charac- 
ters will not be done. 

The initial line-discipline control value is ail bits clear. 

The primary »ocf/(2) system calls have the form: 

ioctl (fildes, command, arg) 
struct termio *arg; 

The commands using this form are: 

TCGETA Get the parameters associated with the terminal 
and store in the termio structure referenced by 
arg. 

TCSETA Set the parameters associated with the terminal 
from the structure referenced by arg. The 
change is immediate. 

TCSETAW Wait for the output to drain before setting the 
new parameters. This form should be used when 
changing parameters that will affect output. 

TCSETAF Wait for the output to drain, then flush the input 
queue and set the new parameters. 

Additional /ocf/(2) calls have the form: 

ioctl (fildes, command, arg) 
int arg; 
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The commands using this form are: 

TCSBRK Wait for the output to drain. If arg is 0, then send 
a break (zero bits for 0.25 seconds). 

TCXONC Start/stop control. If arg is 0, suspend output; if 
1, restart suspended output; if 2, transmit XOFF; 
if 3, transmit XON. 

TCFLSH If arg is 0, flush the input queue; if 1, flush the 
output queue; if 2, flush both the input and output 
queues. 

FILES 

/dev/tty* 

SEE ALSO 

stty{1) in the User's Reference Manual, 

fork(2), ioctl(2), setpgrp(2), signai(2) in the Programmer's 

Reference Manual. 

WARNING 

The default value for ERASE is backspace rather than the his- 
torical #. 
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NAME 

timod - Transport Interface cooperating STREAMS module 
DESCRIPTION 

Timod is a STREAMS module for use with the Transport Inter- 
face (TI) functions of the Network Services library. The timod 
module converts a set of /ocf/(2) calls into STREAMS mes- 
sages that may be consumed by a transport protocol provider 
which supports the Transport Interface. This allows a user to 
initiate certain TI functions as atomic operations, 

The timod module must be pushed (see the System V Operat- 
ing System STREAMS Primer) onto only a stream terminated 
by a transport protocol provider which supports the TI. 

All STREAMS messages, with the exception of the message 
types generated from the ioctl commands described below, 
will be transparently passed to the neighboring STREAMS 
module or driver, The messages generated from the following 
ioctl commands are recognized and processed by the timod 
module. The format of the ioctl call is: 

^include <sys/stropts.h> 



struct strfoctl strioctl; 

strioctl „ic_cmd = and; 
strioctlJc_timeout = INFTIM; 
strioctl, icjen = size; 
strioctl .ic_dp = {char *)buf 

ioctl(fildes, I_STR, astrioctl); 

Where, on issuance, size is the size of the appropriate TI mes- 
sage to be sent to the transport provider and on return size is 
the size of the appropriate TI message from the transport pro- 
vider in response to the issued TI message. Buf is a pointer to 
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a buffer iarge enough to hold the contents of the appropriate 
TI messages. The TI message types are defined in 
< sys/tihdr.h > . The possible values for the cmd field are: 

TI_BIND Bind an address to the underlying transport 

protocol provider. The message issued to the 
TI_BIND hctl is equivalent to the TI message 
type T_BIND_REQ and the message returned 
by the successful completion of the ioctl is 
equivalent to the TI message type 
T_BIND_ACK. 

TIJJ.NBIND Unbind an address from the underlying tran- 
sport protocol provider. The message issued 
to the TI_UNBIND ioctl is equivalent to the TI 
message type TJJNB1NDJREQ and the mes- 
sage returned by the successful completion of 
the ioctl is equivalent to the TI message type 
TOKACK. 

TIGETINFO Get the TI protocol specific information from 
the transport protocol provider. The message 
issued to the TI_GETINFO ioctl is equivalent to 
the TI message type and the message 
returned by the successful completion of the 
ioctl is equivalent to the TI message type 
T_INFO_ACK. 

TI_OPTMGMT Get, set or negotiate protocol specific options 
with the transport protocol provider. The 
message issued to the TI_OPTMGMT ioctl is 
equivalent to the TI message type 
T_OPTMGMT_REQ and the message returned 
by the successful completion of the ioctl is 
equivalent to the TI message type 
T_OPTMGMT_ACK. 

FILES 

< sys/timod.h > 
<sys/tiuser.h> 

< sys/tihdr.h > 
<sys/errno.h> 

SEE ALSO 

tirdwr{7) . 
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System V Operating System STREAMS Primer. 

System V Operating System STREAMS Programmer's Guide. 

System V Operating System Network Programmer's Guide. 

DIAGNOSTICS 

If the ioctl system call returns with a value greater than 0, the 
lower 8 bits of the return value will be one of the TI error 
codes as defined in < sys/tiuser.h > \ If the TI error is of type 
TSYSERR, then the next 8 bits of the return value will contain 
an error as defined in < sys/errno.h > [see A?fro(2)]. 
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NAME 

ttrdwr - Transport Interface read/write interface STREAMS 
module 

DESCRIPTION 

Tirdwr is a STREAMS module that provides an alternate inter- 
face to a transport provider which supports the Transport 
Interface (TI) functions of the Network Services library (see 
Section 3N). This alternate interface allows a user to commun- 
icate with the transport protocol provider using the read {2) 
and write {2) system calls. The putmsg{2) and getmsg{2) sys- 
tem calls may also be used. However, putmsg and getmsg 
can only transfer data messages between user and stream. 

The tirdwr module must only be pushed [see I_PUSH in 
streamio (7)] onto a stream terminated by a transport protocol 
provider which supports the TI. After the tirdwr module has 
been pushed onto a stream, none of the Transport Interface 
functions can be used. Subsequent calls to TI functions will 
cause an error on the stream. Once the error is detected, 
subsequent system calls on the stream will return an error 
with errno set to EPROTO. 

The following are the actions taken by the tirdwr module when 
pushed on the stream, popped [see I_POP in streamio {7)] off 
the stream, or when data passes through it. 

push - When the module is pushed onto a stream, it will 
check any existing data destined for the user to 
ensure that only regular data messages are present. It 
will ignore any messages on the sfream that relate to 
process management, such as messages that gen- 
erate signals to the user processes associated with the 
stream. If any other messages are present, the 
I_PUSH will return an error with errno set to EPROTO. 

write - The module will take the following actions on data that 
originated from a write system call: 

• All messages with the exception of messages that 
contain control portions (see the putmsg and 
getmsg system calls) will be transparently passed 
onto the module's downstream neighbor. 

• Any zero length data messages will be freed by the 
module and they will not be passed onto the 
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module's downstream neighbor. 

• Any messages with control portions will generate an 
error, and any further system calls associated with 
the stream will fail with errno set to EPROTO. 

read - The module will take the following actions on data that 
originated from the transport protocol provider; 

• All messages with the exception of those that con- 
tain control portions (see the putmsg and getmsg 
system calls) will be transparently passed onto the 
module's upstream neighbor. 

• The action taken on messages with control portions 
will be as follows: 

- Messages that represent expedited data will 
generate an error. All further system calls asso- 
ciated with the stream will fail with errno set to 
EPROTO. 

- Any data messages with control portions will 
have the control portions removed from the 
message prior to passing the message on to the 
upstream neighbor. 

- Messages that represent an orderly release indi- 
cation from the transport provider will generate 
a zero length data message, indicating the end 
of file, which will be sent to the reader of the 
sfream. The orderly release message itself will 
be freed by the module. 

- Messages that represent an abortive disconnect 
indication from the transport provider will cause 
all further write and putmsg system calls to fail 
with errno set to ENXIO. All further read and 
getmsg system calls will return zero length data 
(indicating end of file) once all previous data has 
been read. 

- With the exception of the above rules, all other 
messages with control portions will generate an 
error and all further system calls associated with 
the stream will fail with errno set to EPROTO. 
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• Any zero length data messages will be freed by the 
module and they wiii not be passed onto the 
module's upstream neighbor. 

pop- When popping the module off or dosing the stream, 
the module will take the following actions: 

• If an orderly release indication has been previously 
received, then an orderly release request will sent 
to the remote side of the transport connection. 

• If an abortive disconnect has been previously 
received, then no action is taken. 

• If neither an abortive disconnect nor an orderly 
release have been previously received, an abortive 
disconnect will be initiated by the module. 

• If an error has occurred previously and an abortive 
disconnect has not been previously received, an 
abortive disconnect will be initiated by the module. 

SEE ALSO 

stream i o(7), timod(7), 

intro(2), getmsg{2), putmsg(2), read (2), write (2), intro(3) in the 

Programmer's Reference Manual. 

System V Operating System STREAMS Primer, 

System V Operating System STREAMS Programmer's Guide. 

System V Operating System Network Programmer's Guide. 
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NAME 

tty - controlling terminal interface 
DESCRIPTION 

The file /dev/tty is, in each process, a synonym for the control 
terminal associated with the process group of that process, if 
any. It is useful for programs or shell sequences that wish to 
be sure of writing messages on the terminal no matter how 
output has been redirected. It can also be used for programs 
that demand the name of a file for output, when typed output 
is desired and it is tiresome to find out what terminal is 
currently in use. 

FILES 

/dev/tty 
/dev/tty* 



UP-13529 



Page 1 



TTY(7) 



[This page left blank.] 



Page 2 



UP-13529 



VT(7) 



NAME 

vt - virtual terminal 

DESCRIPTION 

A virtual terminal provides a terminal-like communication chan- 
nel between two processes. Each virtual terminal consists of 
two devices: a slave device, whose name is of the firm 
/dev/ttypxx, where xx is the virtual terminal number; and a 
master device, whse name is of the form /dev/vtxx, where xx 
is the virtual terminal number. 

The slave device responds to system calls just like a real termi- 
nal [see termio(7)] so that it can control interactive programs 
such as vi. But instead of doing actual input/output, reads 
and writes on the slave device are written and read on the 
corresponding master device by another process. A typical 
use of a virtual terminal is to put a network server on the mas- 
ter device and login program on the slave. 

The number of virtual terminals must be configured. See 
config (1M). 

FILES 

/dev/ttyp?? slave devices 
/dev/vt?? master devices 

SEE ALSO 

config(1M), termio(7). 

ttyname{3C) in the Programmer's Reference Manual, 
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